Como Carimbar Códigos de Barras em PDFs Usando C

Quais parâmetros o StampToExistingPdfPage requer?

StampToExistingPdfPage() GeneratedBarcode

O trecho de código chama o método StampToExistingPdfPage com um objeto StampSettings para carimbar o objeto no documento PDF. Este método proporciona flexibilidade enquanto mantém a simplicidade. Abaixo estão os parâmetros do método:

• pdfFilePath: Um System.String representando o caminho do documento PDF (relativo ou absoluto).
• x: Um System.Int32 para a posição horizontal em pixels a partir da borda esquerda.
• y: Um System.Int32 para a posição vertical em pixels a partir da borda inferior.
• pageNumber: Um System.Int32 indicando a página (ímpares, primeira página é 1).
• password: Um System.String para PDFs protegidos por senha (opcional).

Quando devo usar o StampToExistingPdfPage?

Executar o trecho de código carimba o GeneratedBarcode diretamente no documento PDF sem salvar intermediário. Este método é adequado para cenários que requerem:

StampToExistingPdfPages() GeneratedBarcode

• Códigos de rastreamento únicos em etiquetas de envio ou documentos de entrega
• Números de lote em relatórios de fabricação
• Números de controle de documentos em formulários legais ou regulamentares
• Códigos QR para autenticação digital ou links de acesso rápido

A abordagem de estampa direta economiza tempo de processamento e elimina arquivos temporários. Para informações sobre diferentes tipos de código de barras, veja o guia de formatos de código de barras suportados.

Quais parâmetros o StampToExistingPdfPages aceita?

Abaixo estão os parâmetros do método:

• pdfFilePath: Um System.String representando o caminho do documento PDF.
• x: Um System.Int32 para a posição horizontal em pixels.
• y: Um System.Int32 para a posição vertical em pixels.
• pageNumbers: Um IEnumerable de páginas a serem carimbadas (ímpares).
• password: Um System.String para PDFs protegidos por senha (opcional).

StampToExistingPdfPages() StampToExistingPdfPage() GeneratedBarcode

Por que usar o StampToExistingPdfPages ao invés de repetir?

Este método oferece estampagem eficiente de código de barras em várias páginas sem iteração manual, melhorando a legibilidade e desempenho do código. A implementação interna otimiza o processamento de PDF, resultando em:

• Execução mais rápida: PDF aberto e processado uma vez, não várias vezes
• Uso de memória reduzido: Gerenciamento eficiente de recursos para PDFs grandes
• Código mais limpo: Sem loop manual e gerenciamento de tratamento de erros
• Operações atômicas: Todas as páginas estampadas em uma operação única

Personalizando a aparência do código de barras antes de estampar

Antes de estampar seu código de barras em um PDF, personalize sua aparência. IronBarcode oferece opções extensas de personalização:

:path=/static-assets/barcode/content-code-examples/how-to/create-and-stamp-barcode-pdf-5.cs

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.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue);

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

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.ChangeBarCodeColor(IronSoftware.Drawing.Color.DarkBlue)

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

Trabalhando com Diferentes Tipos de Código de Barras

Diferentes cenários requerem diferentes tipos de código de barras. Códigos QR são adequados para URLs e grandes conjuntos de dados, enquanto Code128 funciona para identificadores alfanuméricos. Saiba mais sobre criar códigos QR ou explore outros formatos:

:path=/static-assets/barcode/content-code-examples/how-to/create-and-stamp-barcode-pdf-6.cs

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

Tratamento de Erros e Melhores Práticas

Implemente um tratamento de erros adequado ao trabalhar com operações de marcação de PDF:

:path=/static-assets/barcode/content-code-examples/how-to/create-and-stamp-barcode-pdf-7.cs

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
}

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

Considerações sobre o desempenho

Ao trabalhar com PDFs grandes ou múltiplas operações de marcação, considere estas dicas:

1. Operações em Lote: Use StampToExistingPdfPages em vez de repetir StampToExistingPdfPage
2. Cache de Código de Barras: Crie uma vez e reutilize o objeto GeneratedBarcode
3. Cálculo de Coordenadas: Pré-calcule coordenadas de posição consistentes
4. Gerenciamento de Memória: Processe PDFs muito grandes em lotes

Para cenários avançados que envolvem a leitura de códigos de barras de PDFs após a marcação, veja nosso guia sobre leitura de códigos de barras de documentos PDF.