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

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 코드

직접 스탬프 방법은 처리 시간을 절약하고 임시 파일을 제거합니다. 다른 바코드 유형에 대한 정보는 지원되는 바코드 형식 가이드를 참조하십시오.

StampToExistingPdfPages가 수용하는 매개변수는 무엇입니까?

아래는 메소드의 매개변수입니다:

• pdfFilePath: PDF 문서 경로를 나타내는 System.String입니다.
• x: 픽셀 단위의 수평 위치를 나타내는 System.Int32입니다.
• y: 수직 위치를 픽셀 단위로 나타내는 System.Int32형입니다.
• pageNumbers: 스탬프를 찍을 페이지의 IEnumerable</system.int32>(1부터 인덱싱됨).
• password: 암호로 보호된 PDF용 System.String(선택 사항).

StampToExistingPdfPages() StampToExistingPdfPage() GeneratedBarcode

반복 대신 StampToExistingPdfPages를 사용하는 이유는 무엇입니까?

이 메소드는 수동 반복 없이 여러 페이지에 효율적인 바코드 스탬프를 제공하여 코드 가독성과 성능을 향상시킵니다. 내부 구현은 PDF 처리를 최적화하여 다음과 같은 결과를 제공합니다:

• 더 빠른 실행: PDF가 한 번만 열리고 처리됨
• 더 낮은 메모리 사용량: 대용량 PDF를 위한 효율적인 자원 관리
• 더 깔끔한 코드: 수동 루프 및 오류 처리 관리 없음
• 원자적 작업: 모든 페이지가 단일 작업으로 스탬프됨

스탬프 전에 바코드 외형 사용자 정의하기

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)

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

다양한 시나리오에는 다른 바코드 유형이 요구됩니다. 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 문서에서 바코드 읽기를 참조하십시오.