C#でバーコードをPDFとしてエクスポートする方法

なぜ BarCode を PDF ファイルに直接保存するのですか?

バーコードを PDF ファイルに直接保存することは、物理的な文書の生成、印刷可能なラベルの作成、または長期保存のためのバーコードのアーカイブが必要な場合に、最も簡単なアプローチです。 この方法は、在庫管理システム、出荷ラベル、文書生成ワークフローなど、PDF形式が異なるプラットフォームやプリンタ間で一貫したレンダリングを保証する場合に特に有用です。

バーコードを PDF ファイルとして保存するには、まず BarcodeWriter.CreateBarcode を使用して GeneratedBarcode オブジェクトを作成し、次に SaveAsPdf() メソッドを使用して変換し、ディスクに保存します。 次のコードスニペットは、これがどのように機能するかを示しています。

:path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsPdfFile.cs

using IronBarCode;

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.DataMatrix);
myBarcode.SaveAsPdf("myBarcode.pdf");

より高度なバーコード作成オプションについては、さまざまなデータソースからバーコードを作成するに関する包括的なガイドをご覧ください。

どのようなファイルパスのオプションがありますか?

IronBarcodeはPDFファイルの保存に柔軟なファイルパスオプションを提供します。 絶対パス、相対パス、または環境変数を指定できます。 以下は、異なるパスのオプションを示す、より詳細な例です：

using IronBarCode;
using System;
using System.IO;

// Create a barcode
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128);

// Save to current directory
barcode.SaveAsPdf("barcode.pdf");

// Save to absolute path
barcode.SaveAsPdf(@"C:\BarcodeExports\product_barcode.pdf");

// Save to relative path
barcode.SaveAsPdf(@"..\..\exports\barcode.pdf");

// Save using environment path
string documentsPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
barcode.SaveAsPdf(Path.Combine(documentsPath, "barcode.pdf"));

using IronBarCode;
using System;
using System.IO;

// Create a barcode
GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128);

// Save to current directory
barcode.SaveAsPdf("barcode.pdf");

// Save to absolute path
barcode.SaveAsPdf(@"C:\BarcodeExports\product_barcode.pdf");

// Save to relative path
barcode.SaveAsPdf(@"..\..\exports\barcode.pdf");

// Save using environment path
string documentsPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
barcode.SaveAsPdf(Path.Combine(documentsPath, "barcode.pdf"));

この記事では、IronBarcodeを使用してバーコードをPDFにエクスポートする方法について説明します。 IronBarcodeを使用すると、バーコードはファイル、バイナリデータ、またはメモリストリームとしてエクスポートできます。 IronBarcodeの機能の概要については、Getting Start documentationをご覧ください。

どのような場合にファイル エクスポートと他の方法を使い分ける必要がありますか?

ファイルエクスポートを選択してください：

• BarCodeの永久保存が必要です。
• レポートや印刷可能な文書の作成
• オフライン処理用バッチファイルの作成
• ファイルベースのシステムとの統合

バイナリデータやストリームを考慮する

• 即時対応が必要なウェブアプリケーションを扱う
• データベースへの保存
• ファイルシステムにアクセスせずにAPI経由で送信する
• メモリ制約環境での処理

なぜファイルの代わりにバイナリ データを使用するのですか?

バイナリデータのエクスポートは、一時ファイルを作成せずにメモリ内でPDFデータを操作する必要があるシナリオに最適です。 このアプローチは、ウェブアプリケーション、クラウド環境、データベースを使用する場合に特に有効です。 ファイルI/O操作を排除し、データをメモリ内に保持することで、パフォーマンスとセキュリティを向上させます。

PDF バイナリ データとしてエクスポートするには、バーコードを生成してから、ToPdfBinaryData() メソッドを呼び出します。 これは PDF バイナリ データを byte[] 配列として出力します。 次のコードスニペットは、これがどのように機能するかを示しています。

:path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsPdfBinaryData.cs

using IronBarCode;

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.DataMatrix);
byte[] myBarcodeByte = myBarcode.ToPdfBinaryData();

エクスポートする前に、バーコードの外観をカスタマイズすることもできます。 PDFエクスポートを強化するためのバーコードスタイルのカスタマイズについては、こちらをご覧ください。

バイナリ PDF データを API に送信するにはどうすればよいですか?

バイナリPDFデータは、REST APIを通じて簡単に転送できるため、マイクロサービスアーキテクチャに最適です。 以下は、HTTPリクエストでBarCode PDFデータを送信する実用的な例です：

using IronBarCode;
using System.Net.Http;
using System.Threading.Tasks;

public async Task SendBarcodeToAPI()
{
    // Generate barcode and get binary data
    GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("API-DATA-123", BarcodeEncoding.QRCode);
    byte[] pdfData = barcode.ToPdfBinaryData();

    // Send via HTTP POST
    using (HttpClient client = new HttpClient())
    {
        ByteArrayContent content = new ByteArrayContent(pdfData);
        content.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("application/pdf");

        HttpResponseMessage response = await client.PostAsync("https://api.example.com/barcode", content);
        // Handle response
    }
}

using IronBarCode;
using System.Net.Http;
using System.Threading.Tasks;

public async Task SendBarcodeToAPI()
{
    // Generate barcode and get binary data
    GeneratedBarcode barcode = BarcodeWriter.CreateBarcode("API-DATA-123", BarcodeEncoding.QRCode);
    byte[] pdfData = barcode.ToPdfBinaryData();

    // Send via HTTP POST
    using (HttpClient client = new HttpClient())
    {
        ByteArrayContent content = new ByteArrayContent(pdfData);
        content.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("application/pdf");

        HttpResponseMessage response = await client.PostAsync("https://api.example.com/barcode", content);
        // Handle response
    }
}

バイナリ エクスポートの一般的な使用例とは

バイナリエクスポートは、一般的に次のような場面で使用されます：

• データベースストレージ: PDF バーコードを BLOB データとしてデータベースに保存します。
• メール添付：一時ファイルを作成することなく、電子メールに BarCode を添付します。
• クラウド・ストレージ：Azure Blob Storage や AWS S3 などのサービスに直接アップロードできます。
• インメモリ処理：ディスクI/Oなしで複数の操作を連鎖させる
• Web APIレスポンス：HTTP レスポンスで PDF データを直接返す

その他のバーコード生成テクニックやベストプラクティスについては、さまざまなソースからバーコードを作成するガイドをご覧ください。 また、より高度な PDF 操作シナリオのために、 既存の PDF に BarCode をスタンプする方法についても学ぶことができます。

なぜPDFエクスポートにストリームを使用するのですか

ストリームは、特に他 for .NETライブラリと統合する場合や、データフローをきめ細かく制御する必要がある場合に、PDFデータを扱うための最も柔軟なアプローチを提供します。 ストリームは、バッファリングされた読み書きができるため、メモリ効率が重要な大規模処理に特に有用です。

メモリ ストリームとしてエクスポートするには、バーコードを生成してから、ToPdfStream() メソッドを呼び出します。 このメソッドは、System.IO.Stream オブジェクトを返します。 次のコードスニペットは、これがどのように機能するかを示しています。

:path=/static-assets/barcode/content-code-examples/how-to/ExportBarcodeAsPdfStream.cs

using IronBarCode;
using System.IO;

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.DataMatrix);
Stream myBarcodeStream = myBarcode.ToPdfStream();

高度なストリーム操作やその他のエクスポート形式については、exporting barcodes as streams の詳細ガイドを参照してください。

メモリストリームを適切に扱うにはどうすればよいですか?

適切なストリーム処理は、メモリリークを防ぎ、リソースを効率的に使用するために非常に重要です。 以下は、ベストプラクティスを示す包括的な例です：

using IronBarCode;
using System.IO;

public void ProcessBarcodeStream()
{
    // Always use using statements for proper disposal
    using (Stream pdfStream = BarcodeWriter.CreateBarcode("STREAM-123", BarcodeEncoding.Code39).ToPdfStream())
    {
        // Example 1: Copy to file
        using (FileStream fileStream = File.Create("output.pdf"))
        {
            pdfStream.CopyTo(fileStream);
        }

        // Reset stream position for reuse
        pdfStream.Position = 0;

        // Example 2: Read into buffer
        byte[] buffer = new byte[pdfStream.Length];
        pdfStream.Read(buffer, 0, buffer.Length);

        // Example 3: Process with another library
        // ProcessPdfStream(pdfStream);
    }
}

using IronBarCode;
using System.IO;

public void ProcessBarcodeStream()
{
    // Always use using statements for proper disposal
    using (Stream pdfStream = BarcodeWriter.CreateBarcode("STREAM-123", BarcodeEncoding.Code39).ToPdfStream())
    {
        // Example 1: Copy to file
        using (FileStream fileStream = File.Create("output.pdf"))
        {
            pdfStream.CopyTo(fileStream);
        }

        // Reset stream position for reuse
        pdfStream.Position = 0;

        // Example 2: Read into buffer
        byte[] buffer = new byte[pdfStream.Length];
        pdfStream.Read(buffer, 0, buffer.Length);

        // Example 3: Process with another library
        // ProcessPdfStream(pdfStream);
    }
}

バイナリ データよりもストリームを選択する必要があるのはどのような場合ですか?

以下のような場合に、ストリームを選択してください：

• ストリーム入力を期待する他のライブラリとの統合
• コンテンツ全体をメモリにロードすることが実行不可能な、大きなファイルの処理。
• ウェブアプリケーションにストリーミング応答を実装する。
• 他のストリームベースAPIとのチェーン操作について
• パフォーマンスの最適化のためにバッファされた読み取り/書き込みが必要です。

バイナリデータを選択してください：

• 変数またはデータベースへの簡単な保存が必要です。
• 複雑な処理を必要としない素早いシリアライズ。
• バイト配列を期待するAPIでの作業

その他のバーコード生成テクニックやベストプラクティスについては、包括的なバーコードチュートリアルをご覧ください。 また、より高度な PDF 操作シナリオのために、 既存の PDF に BarCode をスタンプする方法についても学ぶことができます。