Çok Büyük PDF'lerde Yavaş Damgalama

Curtis Chau
Curtis Chau
Güncellendi: 19 Ekim 2026

Çok büyük bir PDF'nin her sayfasını tek geçişte damgalamak, iş ilerledikçe giderek yavaşlar. Bildirilmiş 20.000 sayfalık durumda, darboğaz, damgalama işleminin kendisi değil, belgenin bölünmesi için kullanılan yöntemdi.

Mühendisler, 20.000 sayfalık durumda yavaşlamayı damgalama işlemi yerine belge bölme yöntemine kadar izlediler. Ayrıntılı mekanizma, geliştirici notlarından bağımsız olarak doğrulanmamıştır.

Çözüm, PDF'yi küçük parçalar halinde yinelemeli olarak bölmek, her bir parçayı damgalamak (isteğe bağlı olarak paralel işçi süreçlerinde) ve sonuçları tek bir dosyada birleştirmektir.

Çözüm

1. Kaynak PDF'yi Yinelemeli Olarak Bölün

Önerilen: Her bir parça hedef sayfa sayısına kadar veya daha az olana kadar bölmeye devam edin. Bellekte yer tutması için her parçayı diske kaydedin ve işçiler dosyaları bağımsız olarak alabilsin. Dosya adı, parçanın ilk sayfasını saklar, bu da parçaların sırasını korur ve sayfaya bağlı damgaları daha sonra destekler.

using IronPdf;
using IronPdf.Editing;
static void SplitToFiles(PdfDocument doc, int startPage, int targetPages,
                         string outDir, List<string> files)
{
    if (doc.PageCount <= targetPages)
    {
        // File name carries the chunk's first page (1-based).
        string path = Path.Combine(outDir, $"chunk_{startPage:D6}.pdf");
        doc.SaveAs(path);
        files.Add(path);
        return;
    }
    int mid = doc.PageCount / 2;
    using (var left = doc.CopyPages(0, mid - 1))
        SplitToFiles(left, startPage, targetPages, outDir, files);
    using (var right = doc.CopyPages(mid, doc.PageCount - 1))
        SplitToFiles(right, startPage + mid, targetPages, outDir, files);
}
// Usage
var chunkFiles = new List<string>();
using (var source = PdfDocument.FromFile("input.pdf"))
    SplitToFiles(source, 1, 500, @"C:\temp\chunks", chunkFiles);
C#

500 kodlu parça boyutu bir başlangıç noktasıdır. Dokümanlarınız ve donanımınız için bunu ayarlayın.

2. Her Parçayı Damgalayın

Her parçayı açın, damgayı uygulayın ve sonucu yeni bir dosyaya kaydedin.

var stamper = new HtmlStamper("<div style='font-size:24px;color:red'>CONFIDENTIAL</div>")
{
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center,
    Opacity = 50
};
var stampedFiles = new List<string>();
foreach (string file in chunkFiles)
{
    string outPath = file.Replace(".pdf", "_stamped.pdf");
    using (var chunk = PdfDocument.FromFile(file))
    {
        chunk.ApplyStamp(stamper);
        chunk.SaveAs(outPath);
    }
    stampedFiles.Add(outPath);
}
C#

3. Parçaları Paralel İşleyin

Opsiyonel: Her işçi sürecine parça listesinin kendi dilimini verin. Benchmark, 16 çekirdekli bir makinede 8 işçi süreci kullanıyordu. İşçi sayısını donanımınıza göre ayarlayın.

// In each worker process: workerIndex = 0..workerCount-1
var mySlice = chunkFiles.Where((f, i) => i % workerCount == workerIndex);
C#

4. Damgalanmış Parçaları Sırayla Birleştirin

var parts = stampedFiles.OrderBy(f => f)
                        .Select(f => PdfDocument.FromFile(f))
                        .ToList();
using (var merged = PdfDocument.Merge(parts))
{
    merged.SaveAs("output.pdf");
}
parts.ForEach(p => p.Dispose());
C#

İşiniz bittiğinde geçici parça dosyalarını silin.

5. Beklenen Zamanlamalar

20.000 sayfalık benchmark'tan sonuçlar, kaba bir kılavuz olarak:

  • Bölme: yaklaşık 6 dakika
  • Damgalama ve birleştirme, tek süreç: yaklaşık 6 dakika
  • Damgalama ve birleştirme, 8 süreç: yaklaşık 1,5 dakika
  • Toplam paralel çalışma: yaklaşık 8 dakika

Bölme en büyük maliyettir. PDF'yi kendiniz oluşturuyorsanız, başlangıçta parçalara ayırarak oluşturmaya ve bölmeyi atlamaya düşünün.

6. Aynı Deseni Diğer Sayfa Düzeyinde İşlemler İçin Yeniden Kullanma

Bölme, işleme, birleştirme her sayfayı bağımsız olarak ele alan herhangi bir işlem için çalışır. Etkili kullanım:

  • Metin, resim, HTML ve barkod damgaları ve filigranlar
  • HTML başlıkları ve altbilgileri (numaralandırma sürekli olması için FirstPageNumber ayarlayın)
  • Tüm sayfalarda metin karartma
  • Metni bul ve değiştir
  • Görüntü sıkıştırma ve form düzleştirme
  • Arka planlar, ön planlar ve sayfa döndürme

Sayfaya bağlı damgalar (Bates numaraları veya sayfa etiketleri gibi) her parçanın küresel başlangıç sayfasını gerektirir. Bunu parça dosya adından okuyun:

int firstPage = int.Parse(Path.GetFileNameWithoutExtension(file).Split('_')[1]);
for (int i = 0; i < chunk.PageCount; i++)
{
    var bates = new TextStamper { Text = $"ABC{firstPage + i:D7}" };
    chunk.ApplyStamp(bates, i);
}
C#

İlk sayfa numarası chunk_NNNNNN.pdf adından geri çözülür, ardından her sayfa bu küresel başlangıçtan damga posizyonu alır.

Sadece parçalama, birleştirmek gerekmez:

  • Arama indeksleme için metin çıkarma
  • Sayfaları resimlere dönüştürme
  • OCR için sayfaları hazırlama

Bunları birleştirmeden sonra çalıştırın, parça başına değil:

  • Dijital imzalar (birleştirme belgeyi değiştirir ve parça başına imzaları bozar)
  • Şifreler, izinler ve şifreleme
  • Yer işaretleri, ana hatlar ve içerik tabloları
  • Belge meta verileri
  • PDF/A veya PDF/UA dönüştürme
Uyarı: Birleştirilmiş parçalar, yazı tipleri gibi paylaşılan kaynakları tekrarlayabilir. Çıktı boyutunu orijinal ile karşılaştırın ve gerekiyorsa nihai dosyayı sıkıştırın.

Tipik kullanım alanları:

  • Hukuki keşif setleri için Bates numaralandırması
  • Büyük arşivlerde GİZLİ veya TASLAK filigranları
  • Posta sıralama için barkodlu toplu ifadeler veya faturalar
  • İhraç edilen kayıtlarda kişisel verileri karartma
  • Uzun süreli depolamadan önce taranmış arşivleri küçültme

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 22,198,312Sürüm:2026.11yeni çıktı