Cómo estampar códigos de barras en PDF con C

¿Qué parámetros requiere StampToExistingPdfPage?

StampToExistingPdfPage() GeneratedBarcode

El fragmento de código llama al método StampToExistingPdfPage con un objeto StampSettings para imprimir el objeto en el documento PDF. Este método proporciona flexibilidad al tiempo que mantiene la sencillez. A continuación se indican los parámetros del método:

• pdfFilePath: Un System.String que representa la ruta del documento PDF (relativa o absoluta).
• x: Un System.Int32 para la posición horizontal en píxeles desde el borde izquierdo.
• y: Un System.Int32 para la posición vertical en píxeles desde el borde inferior.
• pageNumber: Un System.Int32 que indica la página (indexado desde 1, la primera página es la 1).
• password: Un System.String para PDFs protegidos con contraseña (opcional).

¿Cuándo debo utilizar StampToExistingPdfPage?

Ejecutar el fragmento de código imprime el GeneratedBarcode directamente en el documento PDF sin guardado intermedio. Este método se adapta a situaciones que requieren:

StampToExistingPdfPages() GeneratedBarcode

• Códigos de seguimiento únicos en etiquetas de envío o documentos de entrega
• Números de lote en informes de fabricación
• Números de control de documentos en formularios legales o reglamentarios
• Códigos QR para autenticación digital o enlaces de acceso rápido

El método de estampación directa ahorra tiempo de procesamiento y elimina los archivos temporales. Para obtener información sobre los distintos tipos de códigos de barras, consulte la guía formatos de códigos de barras compatibles.

¿Qué parámetros acepta StampToExistingPdfPages?

A continuación se indican los parámetros del método:

• pdfFilePath: Un System.String que representa la ruta del documento PDF.
• x: Un System.Int32 para la posición horizontal en píxeles.
• y: Un System.Int32 para la posición vertical en píxeles.
• pageNumbers: Un IEnumerable de páginas para imprimir (indexado desde 1).
• password: Un System.String para PDFs protegidos con contraseña (opcional).

StampToExistingPdfPages() StampToExistingPdfPage() GeneratedBarcode

¿Por qué utilizar StampToExistingPdfPages en lugar de Looping?

Este método permite estampar eficazmente códigos de barras en varias páginas sin iteración manual, lo que mejora la legibilidad y el rendimiento del código. La implementación interna optimiza el procesamiento de PDF, lo que resulta en:

• Ejecución más rápida: El PDF se abre y procesa una vez, no varias
• Menor uso de memoria: gestión eficiente de recursos para PDF de gran tamaño
• Código más limpio: Sin gestión manual de bucles y manejo de errores
• Operaciones atómicas: Todas las páginas estampadas en una sola operación

Personalización del aspecto de los códigos de barras antes de estamparlos

Antes de estampar su código de barras en un PDF, personalice su aspecto. IronBarcode ofrece amplias opciones de personalización:

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

Trabajar con diferentes tipos de BarCode

Diferentes escenarios requieren diferentes tipos de códigos de barras. Los códigos QR son adecuados para URL y grandes conjuntos de datos, mientras que Code128 funciona para identificadores alfanuméricos. Más información sobre crear códigos QR o explorar otros 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)

Manejo de errores y buenas prácticas

Implementar un manejo adecuado de errores al trabajar con operaciones de estampado en 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

Consideraciones sobre el rendimiento

Cuando trabaje con PDF de gran tamaño o con varias operaciones de estampado, tenga en cuenta estos consejos:

1. Operaciones en Lote: Usa StampToExistingPdfPages en lugar de repetir StampToExistingPdfPage
2. Almacenamiento en Caché de Código de Barras: Crea una vez y reutiliza el objeto GeneratedBarcode
3. Cálculo de coordenadas: Precalcular coordenadas de posición coherentes
4. Gestión de memoria: Procese PDF muy grandes por lotes

Para escenarios avanzados que impliquen la lectura de códigos de barras de PDF tras el estampado, consulte nuestra guía sobre lectura de códigos de barras de documentos PDF.