Comment estampiller des BarCodes sur des PDF en utilisant C

Quels sont les paramètres requis par StampToExistingPdfPage?

L'extrait de code appelle la méthode StampToExistingPdfPage() avec un objet GeneratedBarcode pour estampiller l'objet sur le document PDF. Cette méthode offre une certaine flexibilité tout en restant simple. Les paramètres de la méthode sont indiqués ci-dessous :

• pdfFilePath: Une chaîne System.String représentant le chemin du document PDF (relatif ou absolu).
• x: Un System.Int32 pour la position horizontale en pixels à partir du bord gauche.
• y: Un System.Int32 pour la position verticale en pixels à partir du bord inférieur.
• pageNumber: Un System.Int32 indiquant la page (indexé à partir de 1, la première page est 1).
• password: Une chaîne System.String pour les PDF protégés par mot de passe (facultatif).

Quand dois-je utiliser StampToExistingPdfPage?

L'exécution de cet extrait de code intègre directement le GeneratedBarcode dans le document PDF sans enregistrement intermédiaire. Cette méthode convient aux scénarios nécessitant :

• Codes de suivi uniques sur les étiquettes d'expédition ou les documents de livraison
• Numéros de lots sur les rapports de fabrication
• Numéros de contrôle des documents sur les formulaires légaux ou réglementaires
• Codes QR pour l'authentification numérique ou les liens d'accès rapide

L'approche de l'estampillage direct permet d'économiser du temps de traitement et d'éliminer les fichiers temporaires. Pour en savoir plus sur les différents types de codes-barres, consultez le guide des formats de codes-barres pris en charge.

Quels sont les paramètres acceptés par StampToExistingPdfPages?

Les paramètres de la méthode sont indiqués ci-dessous :

• pdfFilePath : Une chaîne System.String représentant le chemin d'accès au document PDF.
• x: Un System.Int32 pour la position horizontale en pixels.
• y: Un System.Int32 pour la position verticale en pixels.
• pageNumbers: Un IEnumerable de pages à tamponner (1-indexé).
• password: Une chaîne System.String pour les PDF protégés par mot de passe (facultatif).

Pourquoi utiliser StampToExistingPdfPages au lieu de Looping?

Cette méthode permet d'apposer efficacement des codes-barres sur plusieurs pages sans itération manuelle, ce qui améliore la lisibilité du code et les performances. L'implémentation interne optimise le traitement des PDF, ce qui se traduit par :

• Exécution plus rapide : PDF ouvert et traité une seule fois, et non plusieurs fois
• Moindre utilisation de la mémoire : gestion efficace des ressources pour les PDF volumineux
• Code plus propre : pas de gestion manuelle des boucles et des erreurs
• Opérations atomiques : Toutes les pages sont estampillées en une seule opération

Personnaliser l'apparence du BarCode avant l'estampillage

Avant d'apposer votre BarCode sur un PDF, personnalisez son apparence. 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);

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

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

Travailler avec différents types de BarCodes

Différents scénarios nécessitent différents types de codes-barres. Les codes QR conviennent aux URL et aux grands ensembles de données, tandis que le Code128 convient aux identificateurs alphanumériques. 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);

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

Gestion des erreurs et meilleures pratiques

Mettre en œuvre une gestion correcte des erreurs lors des opérations d'estampillage de 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
}

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

Considérations de performance

Lorsque vous travaillez avec des PDF volumineux ou des opérations d'estampillage multiples, tenez compte des conseils suivants :

1. Opérations par lots : Utilisez StampToExistingPdfPages() au lieu de la boucle StampToExistingPdfPage()
2. Mise en cache des codes-barres : Créez une seule fois l'objet GeneratedBarcode et réutilisez-le.
3. Calcul des coordonnées : Pré-calculer des coordonnées de position cohérentes
4. Gestion de la mémoire : Traiter des PDF très volumineux par lots

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