C# Kullanarak Barkodları PDF'lere Nasıl Damgalarım

StampToExistingPdfPage hangi parametreleri gerektirir?

StampToExistingPdfPage() GeneratedBarcode

Kod parçacığı, nesneyi PDF belgesine damgalamak için StampToExistingPdfPage yöntemini bir StampSettings nesnesiyle çağırır. Bu yöntem sadeliğini korurken esneklik sağlar. Aşağıda yöntem parametreleri verilmiştir:

• pdfFilePath: PDF belgesinin yolunu (göreceli veya mutlak) temsil eden bir System.String.
• x: Sol kenardan itibaren piksel cinsinden yatay konum için bir System.Int32.
• y: Alt kenardan itibaren piksel cinsinden dikey konum için bir System.Int32.
• pageNumber: Sayfayı belirten bir System.Int32 (1'den başlayan indeksleme, ilk sayfa 1'dir).
• password: Parola korumalı PDF'ler için bir System.String (isteğe bağlı).

Ne zaman StampToExistingPdfPage kullanmalıyım?

Kod parçacığını çalıştırmak, ara kaydetme yapmadan GeneratedBarcode etiketini doğrudan PDF belgesine ekler. Bu yöntem, aşağıdaki senaryolar için uygundur:

StampToExistingPdfPages() GeneratedBarcode

• Gönderi etiketleri veya teslimat belgeleri üzerine benzersiz takip kodları
• Üretim raporlarına parti numaraları
• Hukuki veya düzenleyici formlar üzerinde belge kontrol numaraları
• Dijital kimlik doğrulama veya hızlı erişim bağlantıları için QR kodları

Doğrudan damga yaklaşımları işlem süresinden tasarruf sağlar ve geçici dosyaları ortadan kaldırır. Farklı barkod türleri hakkında bilgi için desteklenen barkod formatları kılavuzuna bakın.

StampToExistingPdfPages Hangi Parametreleri Kabul Eder?

Aşağıda yöntem parametreleri verilmiştir:

• pdfFilePath: PDF belgesinin yolunu temsil eden bir System.String.
• x: Pikseller cinsinden yatay konum için bir System.Int32.
• y: Dikey konumun piksel cinsinden değeri için bir System.Int32.
• pageNumbers: Damgalanacak sayfaların IEnumerable</system.int32> dizisi (1'den başlayan indeksli).
• password: Parola korumalı PDF'ler için bir System.String (isteğe bağlı).

StampToExistingPdfPages() StampToExistingPdfPage() GeneratedBarcode

Döngüyü Kullanmak Yerine StampToExistingPdfPages Neden Kullanılır?

Bu yöntem, manuel yineleme olmadan çok sayfalı etkili barkod damgalama sağlar, kod okunabilirliğini ve performansını artırır. Dahili uygulama, PDF işlemesini optimize ederek şu sonuçları doğurur:

• Daha hızlı yürütme: PDF bir kez açılır ve işlenir, birden fazla kez değil
• Daha düşük bellek kullanımı: Büyük PDF'ler için verimli kaynak yönetimi
• Daha temiz kod: Manuel döngü ve hata yönetimi gerektirmez
• Atomik işlemler: Tüm sayfalar tek bir işlemde damgalanır

Barkod Görünümünü Damgalamadan Önce Özelleştirme

Barkodunuzu bir PDF'ye damgalamadan önce görünümünü özelleştirin. IronBarcode, kapsamlı özelleştirme seçenekleri sunar:

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)

Farklı Barkod Türleriyle Çalışma

Farklı senaryolar farklı barkod türleri gerektirir. QR kodları URL'ler ve büyük veri setleri için uygundur, Code128 ise alfanümerik tanımlayıcılar için çalışır. QR kodları oluşturma hakkında daha fazla bilgi edinin veya diğer formatları keşfedin:

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

Hata Yönetimi ve En İyi Uygulamalar

PDF damgalama işlemleriyle çalışırken uygun hata yönetimini uygulayın:

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

Performans Hususları

Büyük PDF'lerle veya birden fazla damgalama işlemiyle çalışırken şu ipuçlarını göz önünde bulundurun:

1. Toplu İşlemler: Döngü yerine StampToExistingPdfPages kullanın StampToExistingPdfPage
2. BarCode Önbellekleme: GeneratedBarcode nesnesini bir kez oluşturun ve yeniden kullanın
3. Koordinat Hesaplama: Tutarlı pozisyon koordinatlarını önceden hesaplayın
4. Bellek Yönetimi: Çok büyük PDF'leri parçalara ayırarak işleyin

Damgalamadan sonra PDF'lerden barkod okuma içeren ileri senaryolar için, PDF belgelerinden barkod okuma rehberimize bakın.