C#을 사용하여 PDF에 바코드를 스탬프하는 방법

StampToExistingPdfPage에 필요한 매개변수는 무엇입니까?

코드 스니펫은 GeneratedBarcode 객체와 함께 StampToExistingPdfPage() 메서드를 호출하여 객체를 PDF 문서에 스탬프합니다. 이 메소드는 단순성을 유지하면서 유연성을 제공합니다. 아래는 메소드의 매개변수입니다:

• pdfFilePath: PDF 문서 경로(상대 또는 절대)를 나타내는 System.String입니다.
• x: 왼쪽 가장자리에서 픽셀 수로 가로 위치를 나타내는 System.Int32입니다.
• y: 아래쪽 가장자리에서 픽셀 수로 세로 위치를 나타내는 System.Int32입니다.
• pageNumber: 페이지(1부터 시작, 첫 번째 페이지는 1)를 나타내는 System.Int32입니다.
• 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: 스탬프할 페이지(1부터 시작)에 대한 IEnumerable입니다.
• 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);

다른 바코드 유형과 작업하기

다양한 시나리오에는 다른 바코드 유형이 요구됩니다. 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. 일괄 작업: StampToExistingPdfPage()를 반복하는 대신 StampToExistingPdfPages()를 사용하세요
2. 바코드 캐싱: 한번 생성하여 GeneratedBarcode 객체를 재사용하세요
3. 좌표 계산: 일관된 위치 좌표를 미리 계산하십시오
4. 메모리 관리: 매우 큰 PDF를 배치로 처리하십시오

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