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

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

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

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

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

コード スニペットを実行すると、中間保存なしで、GeneratedBarcode が PDF ドキュメントに直接スタンプされます。 この方法は、以下のようなシナリオに適しています：

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

ダイレクトスタンプ方式は、処理時間を節約し、一時ファイルを排除します。 For information on different barcode types, see the supported barcode formats guide.

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

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

• pdfFilePath: PDF ドキュメントのパスを表すSystem.String 。
• x: ピクセル単位の水平位置を表すSystem.Int32 。
• y: ピクセル単位の垂直位置を表すSystem.Int32 。
• pageNumbers: IEnumerableスタンプするページ数(1から始まるインデックス)。
• password: パスワードで保護された PDF のSystem.String (オプション)。

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

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

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

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

バーコードをPDFにスタンプする前に、その外観をカスタマイズしてください。 IronBarcode offers extensive customization options:

GeneratedBarcode myBarcode = 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(System.Drawing.Color.DarkBlue);

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

GeneratedBarcode myBarcode = 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(System.Drawing.Color.DarkBlue);

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

異なる BarCode タイプを扱う

シナリオによって、必要なBarCodeの種類は異なります。QRコードはURLや大きなデータセットに適しており、Code128は英数字の識別子に適しています。 Learn more about creating QR codes or explore other formats:

// 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);

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

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

try
{
    GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("DOCUMENT-ID-12345", 
        BarcodeEncoding.Code128, 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.Code128, 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
}

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

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

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

For advanced scenarios involving reading barcodes from PDFs after stamping, see our guide on reading barcodes from PDF documents.