如何使用 C# 在 PDF 上新增條碼

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 文件中，而無需中間儲存。 此方法適用於以下情況：

• 貨運標籤或送貨單上的唯一追蹤碼 生產報告上的批號
• 法律或監管表格上的文件控制編號
• 用於數位認證或快速存取連結的二維碼

直接蓋章方式節省了處理時間，且無需臨時文件。 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 而不是循環？

此方法無需手動迭代即可在多頁上有效地蓋印條碼，從而提高條碼的可讀性和效能。 內部實作優化了PDF處理，結果如下：

-執行速度更快：PDF 文件只需打開和處理一次，無需多次處理 -更低的記憶體佔用：高效率管理大型 PDF 檔案的資源 -更簡潔的程式碼：無需手動循環和錯誤處理管理 -原子操作：所有頁面在一次操作中被蓋章

蓋章前自訂條碼外觀

在將條碼新增至 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);

使用不同類型的條碼

不同的應用場景需要不同的條碼類型。二維碼適用於網址和大型資料集，而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.