C#を使用して PDF に BarCode をスタンプする方法

StampToExistingPdfPageはどのようなパラメータを必要としますか?

StampToExistingPdfPage() GeneratedBarcode

このコードスニペットは、StampToExistingPdfPage メソッドを StampSettings オブジェクトと共に呼び出し、そのオブジェクトを PDF 文書にスタンプします。 この方法は、シンプルさを維持しながら、柔軟性を提供します。 以下はメソッドのパラメータです：

• pdfFilePath: PDFドキュメントのパス（相対パスまたは絶対パス）を表す System.String。
• x: 左端からの水平位置（ピクセル単位）を表す System.Int32 型。
• y: 下端からの垂直位置（ピクセル単位）を表す System.Int32 型。
• pageNumber: ページ番号を示す System.Int32 型（1 から始まるインデックス、最初のページは 1）。
• password: パスワードで保護されたPDF用のSystem.String（オプション）。

いつ StampToExistingPdfPage を使用する必要がありますか?

このコードスニペットを実行すると、中間保存を行わずに GeneratedBarcode が PDF 文書に直接埋め込まれます。 この方法は、以下のようなシナリオに適しています：

StampToExistingPdfPages() GeneratedBarcode

• 配送ラベルや配送書類のユニークな追跡コード
• 製造報告書のバッチ番号
• 法的または規制上の文書管理番号
• デジタル認証やクイックアクセスリンク用のQRコード

ダイレクトスタンプ方式は、処理時間を節約し、一時ファイルを排除します。 さまざまなバーコードの種類については、supported barcode formatsガイドを参照してください。

StampToExistingPdfPagesはどのようなパラメータを受け付けますか?

以下はメソッドのパラメータです：

• pdfFilePath: PDFドキュメントのパスを表す System.String。
• x: 水平位置（ピクセル単位）を表す System.Int32 型。
• y: ピクセル単位の垂直位置を表す System.Int32。
• pageNumbers: スタンプを付けるページの IEnumerable</system.int32> 配列（インデックスは 1 から）。
• password: パスワードで保護されたPDF用のSystem.String（オプション）。

StampToExistingPdfPages() StampToExistingPdfPage() GeneratedBarcode

なぜループではなく StampToExistingPdfPages を使用するのですか?

この方法では、手作業による反復作業を行うことなく、複数のページに効率的に BarCode をスタンプすることができ、コードの可読性とパフォーマンスが向上します。 内部実装は、PDF処理を最適化し、以下のような結果をもたらします：

• より高速な実行：PDFは複数回ではなく、一度だけ開いて処理されます。
• メモリ使用量の削減: 大容量PDFの効率的なリソース管理
• よりクリーンなコード: 手動のループとエラー処理の管理はありません。
• 原子操作：すべてのページが1回の操作でスタンプされる

スタンプ前のバーコードの外観をカスタマイズする

バーコードをPDFにスタンプする前に、その外観をカスタマイズしてください。 IronBarcodeは幅広いカスタマイズオプションを提供しています：

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("INVOICE-2024-001", BarcodeEncoding.Co/de128, 250, 80);

// Customize the appearance
myBarcode.AddAnnotationTextAboveBarcode("Invoice Number");
myBarcode.AddAnnotationTextBelowBarcode("Scan for digital copy");
myBarcode.SetMargins(10);
myBarcode.ChangeBarcodeForegroundColor(System.Drawing.Co/lor.DarkBlue);

// Now stamp the customized barcode
myBarcode.StampToExistingPdfPage("invoice.pdf", x: 450, y: 700, pageNumber: 1);

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("INVOICE-2024-001", BarcodeEncoding.Co/de128, 250, 80);

// Customize the appearance
myBarcode.AddAnnotationTextAboveBarcode("Invoice Number");
myBarcode.AddAnnotationTextBelowBarcode("Scan for digital copy");
myBarcode.SetMargins(10);
myBarcode.ChangeBarcodeForegroundColor(System.Drawing.Co/lor.DarkBlue);

// Now stamp the customized barcode
myBarcode.StampToExistingPdfPage("invoice.pdf", x: 450, y: 700, pageNumber: 1);

Imports System.Drawing

Dim myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("INVOICE-2024-001", BarcodeEncoding.Code128, 250, 80)

' Customize the appearance
myBarcode.AddAnnotationTextAboveBarcode("Invoice Number")
myBarcode.AddAnnotationTextBelowBarcode("Scan for digital copy")
myBarcode.SetMargins(10)
myBarcode.ChangeBarcodeForegroundColor(Color.DarkBlue)

' Now stamp the customized barcode
myBarcode.StampToExistingPdfPage("invoice.pdf", x:=450, y:=700, pageNumber:=1)

異なる BarCode タイプを扱う

シナリオによって、必要なBarCodeの種類は異なります。QRコードはURLや大きなデータセットに適しており、Code128は英数字の識別子に適しています。 QRコードの作成についての詳細や、他のフォーマットについてもご覧ください：

// QR Code for contact information
var qrCode = BarcodeWriter.CreateBarcode("BEGIN:VCARD\nFN:John Doe\nTEL:555-1234\nEND:VCARD", 
    BarcodeEncoding.QRCode, 150, 150);
qrCode.StampToExistingPdfPage("businesscard.pdf", x: 400, y: 50, pageNumber: 1);

// Data Matrix for product tracking
var dataMatrix = BarcodeWriter.CreateBarcode("PROD-2024-BATCH-789", 
    BarcodeEncoding.DataMatrix, 100, 100);
dataMatrix.StampToExistingPdfPage("product_sheet.pdf", x: 50, y: 750, pageNumber: 1);

// QR Code for contact information
var qrCode = BarcodeWriter.CreateBarcode("BEGIN:VCARD\nFN:John Doe\nTEL:555-1234\nEND:VCARD", 
    BarcodeEncoding.QRCode, 150, 150);
qrCode.StampToExistingPdfPage("businesscard.pdf", x: 400, y: 50, pageNumber: 1);

// Data Matrix for product tracking
var dataMatrix = BarcodeWriter.CreateBarcode("PROD-2024-BATCH-789", 
    BarcodeEncoding.DataMatrix, 100, 100);
dataMatrix.StampToExistingPdfPage("product_sheet.pdf", x: 50, y: 750, pageNumber: 1);

' QR Code for contact information
Dim qrCode = BarcodeWriter.CreateBarcode("BEGIN:VCARD" & vbLf & "FN:John Doe" & vbLf & "TEL:555-1234" & vbLf & "END:VCARD", 
    BarcodeEncoding.QRCode, 150, 150)
qrCode.StampToExistingPdfPage("businesscard.pdf", x:=400, y:=50, pageNumber:=1)

' Data Matrix for product tracking
Dim dataMatrix = BarcodeWriter.CreateBarcode("PROD-2024-BATCH-789", 
    BarcodeEncoding.DataMatrix, 100, 100)
dataMatrix.StampToExistingPdfPage("product_sheet.pdf", x:=50, y:=750, pageNumber:=1)

エラー処理とベストプラクティス

PDFのスタンピング操作の際に、適切なエラー処理を実装すること：

try
{
    GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("DOCUMENT-ID-12345", 
        BarcodeEncoding.Co/de128, 200, 60);

    // Verify the PDF exists before attempting to stamp
    if (File.Exists("target.pdf"))
    {
        myBarcode.StampToExistingPdfPage("target.pdf", x: 100, y: 100, pageNumber: 1);
        Console.WriteLine("Barcode stamped successfully!");
    }
    else
    {
        Console.WriteLine("PDF file not found!");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error stamping barcode: {ex.Message}");
    // Log the error or handle it appropriately
}

try
{
    GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("DOCUMENT-ID-12345", 
        BarcodeEncoding.Co/de128, 200, 60);

    // Verify the PDF exists before attempting to stamp
    if (File.Exists("target.pdf"))
    {
        myBarcode.StampToExistingPdfPage("target.pdf", x: 100, y: 100, pageNumber: 1);
        Console.WriteLine("Barcode stamped successfully!");
    }
    else
    {
        Console.WriteLine("PDF file not found!");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error stamping barcode: {ex.Message}");
    // Log the error or handle it appropriately
}

Imports System
Imports System.IO

Try
    Dim myBarcode As GeneratedBarcode = BarcodeWriter.CreateBarcode("DOCUMENT-ID-12345", BarcodeEncoding.Code128, 200, 60)

    ' Verify the PDF exists before attempting to stamp
    If File.Exists("target.pdf") Then
        myBarcode.StampToExistingPdfPage("target.pdf", x:=100, y:=100, pageNumber:=1)
        Console.WriteLine("Barcode stamped successfully!")
    Else
        Console.WriteLine("PDF file not found!")
    End If
Catch ex As Exception
    Console.WriteLine($"Error stamping barcode: {ex.Message}")
    ' Log the error or handle it appropriately
End Try

パフォーマンスの考慮事項

大きなPDFや複数のスタンプ操作を行う場合は、以下のヒントを考慮してください：

1. バッチ処理: ループ処理の代わりに StampToExistingPdfPages を使用してください StampToExistingPdfPage
2. BarCodeのキャッシュ: GeneratedBarcode オブジェクトを一度作成して再利用 3.座標計算：一貫した位置座標を事前に計算します。 4.メモリ管理：非常に大きなPDFをバッチ処理

スタンプ後にPDFからバーコードを読み取る高度なシナリオについては、PDFドキュメントからバーコードを読み取るのガイドを参照してください。