Stempeln von BarCodes auf PDFs mit C#

Hairil Hasyimi Bin Omar
Hairil Hasyimi Bin Omar
Aktualisiert: 2. August 2026

Stempeln Sie Barcodes auf vorhandene PDF-Dokumente in C# mit der CreateBarcode Methode von IronBarcode und verwenden Sie StampToExistingPdfPage für einzelne Seiten oder StampToExistingPdfPages für mehrere Seiten, wobei Sie Koordinaten und Seitennummern angeben.

Schnellstart: Einen GeneratedBarcode auf eine PDF-Seite stempeln

Dieses Beispiel zeigt, wie ein Barcode mit IronBarcode's CreateBarcode generiert und auf eine vorhandene PDF-Seite gestempelt wird. Geben Sie den PDF-Pfad, die Positionskoordinaten und die Seitenzahl an.

  1. 1Installieren Sie IronBarcode mit NuGet Package Manager

    PM > Install-Package BarCode

  2. 2Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    IronBarCode.BarcodeWriter.CreateBarcode("https://my.site", IronBarCode.BarcodeEncoding.QRCode, 150, 150)
        .StampToExistingPdfPage("report.pdf", x: 50, y: 50, pageNumber: 1);
  3. 3Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronBarcode in Ihrem Projekt mit einer kostenlosen Testversion zu verwenden
    arrow pointer

StampToExistingPdfPage StampToExistingPdfPages

Wie kann ich einen BarCode auf eine bestehende PDF-Seite stempeln?

Neben dem Export von Barcodes als PDF ermöglicht IronBarcode das direkte Stempeln des GeneratedBarcode auf bestehende PDF-Dokumente. Diese Funktion ist nützlich beim Hinzufügen von Tracking-Codes, Inventar-Etiketten oder Dokumentenkennungen zu bestehenden Berichten, Rechnungen oder Formularen. Der folgende Codeschnipsel veranschaulicht diese Aufgabe.

using IronBarCode;

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.Code128, 200, 100);
myBarcode.StampToExistingPdfPage("pdf_file_path.pdf", x: 200, y: 100, 3, "password");

Welche Parameter sind für StampToExistingPdfPage erforderlich?

StampToExistingPdfPage() GeneratedBarcode

Der Code-Schnipsel ruft die StampToExistingPdfPage-Methode auf, um das Objekt auf das PDF-Dokument zu stempeln. Diese Methode bietet Flexibilität bei gleichzeitiger Einfachheit. Im Folgenden finden Sie die Parameter der Methode:

  • pdfFilePath: Ein System.String, das den Pfad des PDF-Dokuments repräsentiert (relativ oder absolut).
  • x: Ein System.Double für die horizontale Position in Pixeln von der linken Kante.
  • y: Ein System.Double für die vertikale Position in Pixeln vom unteren Rand.
  • pageNumber: Ein System.Int32, der die Seite angibt (1-indexiert, erste Seite ist 1).
  • password: Ein System.String für passwortgeschützte PDFs (optional).

Wann sollte ich StampToExistingPdfPage verwenden?

Das Ausführen des Code-Schnipsels stempelt den GeneratedBarcode direkt in das PDF-Dokument, ohne es zwischenspeichern zu müssen. Diese Methode eignet sich für Szenarien, die Folgendes erfordern:

StampToExistingPdfPages() GeneratedBarcode

  • Einzigartige Tracking-Codes auf Versandetiketten oder Lieferdokumenten
  • Chargennummern auf Herstellungsberichten
  • Dokumentenkontrollnummern auf rechtlichen oder regulatorischen Formularen
  • QR-Codes für digitale Authentifizierung oder Schnellzugriffslinks

Der Ansatz des direkten Stempelns spart Bearbeitungszeit und eliminiert temporäre Dateien. Informationen zu verschiedenen Barcode-Typen finden Sie im Leitfaden für unterstützte Barcode-Formate.

Wie kann ich einen BarCode auf mehrere PDF-Seiten stempeln?

Manchmal muss derselbe BarCode auf mehreren Seiten eingeprägt werden. Zu den üblichen Verwendungszwecken gehören das Anbringen von Dokumentenkennungen auf jeder Seite mehrseitiger Berichte, das Hinzufügen von Versionskontrollcodes in technischen Dokumenten oder das Einfügen von Sicherheitsbarcodes auf jeder Seite vertraulicher Materialien. Verwenden Sie statt des Schleifens der Einzelseitenmethode die StampToExistingPdfPages-Methode auf dem GeneratedBarcode-Objekt. Der folgende Codeschnipsel veranschaulicht diese Methode.

using IronBarCode;
using System.Collections.Generic;

GeneratedBarcode myBarcode = BarcodeWriter.CreateBarcode("https://ironsoftware.com/csharp/barcode/", BarcodeEncoding.Code128, 200, 100);
List<int> pages = new List<int>();
pages.Add(1);
pages.Add(2);
pages.Add(3);
myBarcode.StampToExistingPdfPages("pdf_file_path.pdf", x: 200, y: 100, pages, "password");

Für mehr Flexibilität sollten Sie LINQ verwenden, um Seitenbereiche dynamisch zu generieren:

// Stamp on all even pages from 2 to 10
var evenPages = Enumerable.Range(1, 10).Where(x => x % 2 == 0).ToList();
myBarcode.StampToExistingPdfPages("pdf_file_path.pdf", x: 200, y: 100, evenPages, "password");

// Stamp on the first and last 3 pages of a 20-page document
var selectedPages = new List<int> { 1, 2, 3, 18, 19, 20 };
myBarcode.StampToExistingPdfPages("pdf_file_path.pdf", x: 200, y: 100, selectedPages, "password");

Welche Parameter akzeptiert StampToExistingPdfPages?

Im Folgenden finden Sie die Parameter der Methode:

  • pdfFilePath: Ein System.String, das den Pfad des PDF-Dokuments repräsentiert.
  • x: Ein System.Double für die horizontale Position in Pixeln.
  • y: Ein System.Double für die vertikale Position in Pixeln.
  • pageNumbers: Ein IEnumerable<System.Int32> der Seiten, die gestempelt werden sollen (1-indexiert).
  • password: Ein System.String für passwortgeschützte PDFs (optional).

StampToExistingPdfPages() StampToExistingPdfPage() GeneratedBarcode

Warum StampToExistingPdfPages anstelle einer Schleife verwenden?

Diese Methode ermöglicht ein effizientes Stempeln von Barcodes auf mehreren Seiten ohne manuelle Iteration und verbessert die Lesbarkeit und Leistung des Codes. Die interne Implementierung optimiert die PDF-Verarbeitung, was sich in:

  • Schnellere Ausführung: PDF wird einmal geöffnet und bearbeitet, nicht mehrfach
  • Weniger Speicherverbrauch: Effizientes Ressourcenmanagement für große PDFs
  • Sauberer Code: Keine manuelle Schleifen- und Fehlerbehandlungsverwaltung
  • Atomare Operationen: Alle Seiten in einem einzigen Vorgang gestempelt

Fortgeschrittene Stanztechniken

Anpassen des Aussehens von BarCodes vor dem Stempeln

Bevor Sie Ihren Barcode in eine PDF-Datei stempeln, sollten Sie sein Aussehen anpassen. IronBarcode bietet umfangreiche Anpassungsoptionen:

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

Arbeiten mit verschiedenen BarCode-Typen

Verschiedene Szenarien erfordern unterschiedliche Barcodetypen. QR-Codes eignen sich für URLs und große Datensätze, während Code128 für alphanumerische Bezeichnungen geeignet ist. Erfahren Sie mehr über das Erstellen von QR-Codes oder erkunden Sie andere Formate:

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

Fehlerbehandlung und bewährte Praktiken

Implementierung einer angemessenen Fehlerbehandlung bei der Arbeit mit PDF-Stempeloperationen:

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
}

Erwägungen zur Leistung

Wenn Sie mit großen PDF-Dateien oder mehreren Stempelvorgängen arbeiten, sollten Sie diese Tipps beachten:

  1. Batch-Operationen: Verwenden Sie StampToExistingPdfPages anstelle der Schleife StampToExistingPdfPage
  2. Barcode-Caching: Erstellen Sie einmal und verwenden Sie das GeneratedBarcode-Objekt erneut
  3. Koordinatenberechnung: Berechnen Sie konsistente Positionskoordinaten vor
  4. Speicherverwaltung: Bearbeiten Sie sehr große PDFs in Chargen

Für fortgeschrittene Szenarien, die das Lesen von Barcodes aus PDFs nach dem Stempeln betreffen, siehe unser Handbuch zum Lesen von Barcodes aus PDF-Dokumenten.

Integration mit anderen IronBarcode-Funktionen

Die PDF-Stempelfunktionalität funktioniert mit anderen IronBarcode-Funktionen. Kombinieren Sie es mit asynchroner Verarbeitung für eine bessere Webanwendungsleistung:

// Asynchronous PDF stamping
public async Task StampBarcodeAsync(string pdfPath, string barcodeData)
{
    await Task.Run(() =>
    {
        var barcode = BarcodeWriter.CreateBarcode(barcodeData, BarcodeEncoding.QRCode, 200, 200);
        barcode.StampToExistingPdfPage(pdfPath, x: 100, y: 100, pageNumber: 1);
    });
}

Nutzen Sie zudem die Bildkorrekturfunktionen von IronBarcode, wenn Sie mit gescannten PDFs arbeiten, die möglicherweise vor oder nach dem Barcode-Stempeln verbessert werden müssen.

Behebung häufiger Probleme

Wenn Sie beim Stempeln von Barcodes auf PDFs auf Probleme stoßen, finden Sie hier Lösungen:

  1. Koordinatenprobleme: PDF-Koordinaten beginnen unten links, nicht oben links
  2. Passwortgeschützte PDFs: Stellen Sie das korrekte Passwortparameter für verschlüsselte PDFs sicher
  3. Große Dateigrößen: Für Optimierungs- und Handhabungstipps lesen Sie unser Troubleshooting-Handbuch
  4. Schrift- oder Codierungsprobleme: Für Sonderzeichen oder Unicode lesen Sie unser Handbuch zum Schreiben von Unicode-Barcodes

Die Befolgung dieser Richtlinien und die Nutzung der IronBarcode-Funktionen zum Stempeln von PDF-Dokumenten ermöglicht das effiziente Hinzufügen von Barcodes zu bestehenden PDF-Dokumenten bei gleichzeitiger Beibehaltung einer hohen Leistung und Codequalität.

Häufig gestellte Fragen

Was ist die primäre Methode, um mit IronBarcode einen Barcode auf ein PDF zu stempeln?

Die primäre Methode, um mit IronBarcode einen Barcode auf ein PDF zu stempeln, ist die StampToExistingPdfPage-Methode.

Kann IronBarcode Barcodes auf mehreren PDF-Seiten gleichzeitig stempeln?

Ja, IronBarcode unterstützt das Stempeln von Barcodes auf mehreren PDF-Seiten mittels der StampToExistingPdfPages-Methode.

Was sind einige gängige Anwendungsfälle für das Stempeln von Barcodes auf PDFs?

Gängige Anwendungsfälle für das Stempeln von Barcodes auf PDFs sind das Hinzufügen von Tracking-Codes, Inventaretiketten oder Dokumentenkennungen zu Berichten, Rechnungen oder Formularen.

Wie spezifizieren Sie die Position eines Barcodes auf einer PDF-Seite in IronBarcode?

In IronBarcode spezifizieren Sie die Position eines Barcodes auf einer PDF-Seite mithilfe der x- und y-Parameter, die die Koordinaten in Pixel darstellen.

Unterstützt IronBarcode passwortgeschützte PDFs beim Stempeln von Barcodes?

Ja, IronBarcode unterstützt passwortgeschützte PDFs. Sie können ein Passwort als optionalen Parameter angeben, wenn Sie die StampToExistingPdfPage- oder StampToExistingPdfPages-Methoden verwenden.

Welche Barcode-Typen können mit IronBarcode für das Stempeln auf PDFs erzeugt werden?

IronBarcode kann verschiedene Barcode-Typen generieren, einschließlich QR-Codes und Code128, die auf PDFs gestempelt werden können.

Wie können Sie das Erscheinungsbild eines Barcodes anpassen, bevor Sie ihn auf ein PDF in IronBarcode stempeln?

Sie können das Erscheinungsbild eines Barcodes in IronBarcode anpassen, indem Sie Methoden wie AddAnnotationTextAboveBarcode, AddAnnotationTextBelowBarcode und ChangeBarCodeColor verwenden, bevor Sie stempeln.

Warum sollten Sie die StampToExistingPdfPages-Methode anstelle des Schleifens für mehrere Seiten verwenden?

Die StampToExistingPdfPages-Methode wird für das Stempeln auf mehreren Seiten bevorzugt, da sie effizienter ist, die Verarbeitungszeit reduziert und die Ressourcennutzung im Vergleich zum manuellen Schleifen durch Seiten optimiert.

Gibt es Leistungsaspekte zu beachten, wenn Barcodes auf großen PDFs mit IronBarcode gestempelt werden?

Ja, wenn Barcodes auf großen PDFs gestempelt werden, wird empfohlen, Batch-Operationen zu verwenden, Barcodes zu cachen und den Speicher effizient zu verwalten, um eine bessere Leistung mit IronBarcode zu erzielen.

Was sollte getan werden, wenn ein Barcode-Stempelvorgang in IronBarcode fehlschlägt?

Wenn ein Barcode-Stempelvorgang fehlschlägt, implementieren Sie Fehlerbehandlung mit try-catch-Blöcken, um Fehler zu protokollieren und sicherzustellen, dass die PDF-Datei vor dem Stempeln mit IronBarcode existiert.

Bereit loszulegen?

NuGet-Downloads 2,564,559Version:2026.11gerade veröffentlicht