Geniş PDF'lerde Başlıklar ve Altbilgiler Eklemek

Curtis Chau
Curtis Chau
Güncellendi: 21 Ağustos 2026

Tek seferde çok büyük bir PDF'ye başlık ve altbilgi eklemek yavaş olabilir. Belgeyi sabit boyutlu sayfa parçalarında işleyin, ardından sonuçları birleştirin, böylece sayfa numaralarını tüm belge boyunca sürekli tutarken render süresini kısaltın.

Çözüm

1. Sayfa dizinlerini partilere ayırın

Bir parça boyutu seçin ve belgenin sayfa dizinlerini sabit boyutlu kümelere ayırın (aşağıda her biri 300 sayfa). Bu, her bir render geçişinin kaç sayfa ile ilgilenmesi gerektiğine karar verir.

2. Her partiyi kendi dokümanına kopyalayın

CopyPages ile mevcut kümenin sayfalarını çıkarın, böylece her bir parça bağımsız bir PdfDocument olur.

3. Sürekli numaralandırma ile başlık ve altbilgiler ekleyin

FirstPageNumber, parçanın başlangıç sayfasına ayarlayın. Bu, sayfa numaralarını her parçada 1'den başlamak yerine tüm belge boyunca sürekli tutar.

4. Her parçayı kaydedin ve dispose edin

Her bir parçayı bir geçici dosyaya yazın ve ardından bu dosyayı yok edin. Sonraki kümeden önce parçayı serbest bırakmak belleği kontrol altında tutar.

5. Parçaları birleştirin ve son PDF'yi kaydedin

Geçici dosyaları yeniden açın, AppendPdf ile sırayla ekleyin, sonucu kaydedin, ardından geçici dosyaları silin.

using IronPdf;
var pdf = PdfDocument.FromFile("input.pdf");
string headerHtml = "<div style='font-size:10px;'>Header</div>";
string footerHtml = "<div style='text-align:right;font-size:10px;'>Page {page} of {total-pages}</div>";
int chunkSize = 300;
var pageChunks = Enumerable.Range(0, pdf.PageCount)
    .GroupBy(i => i / chunkSize)
    .Select(g => g.ToArray())
    .ToList();
var tempFiles = new List<string>();
foreach (var indexes in pageChunks)
{
    var chunkPdf = pdf.CopyPages(indexes);
    int globalStartPage = indexes.First() + 1;
    chunkPdf.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
    {
        FirstPageNumber = globalStartPage,          // keeps numbering continuous
        HtmlHeader = new HtmlHeaderFooter { HtmlFragment = headerHtml, MaxHeight = 40 },
        HtmlFooter = new HtmlHeaderFooter { HtmlFragment = footerHtml, MaxHeight = 40 }
    });
    string tempFile = Path.GetTempFileName() + ".pdf";
    chunkPdf.SaveAs(tempFile);
    chunkPdf.Dispose();
    tempFiles.Add(tempFile);
}
// Merge the chunks back into one document.
var finalPdf = new PdfDocument(tempFiles.First());
foreach (var file in tempFiles.Skip(1))
{
    using var part = new PdfDocument(file);
    finalPdf.AppendPdf(part);
}
finalPdf.SaveAs("output.pdf");
finalPdf.Dispose();
// Clean up temp files.
foreach (var file in tempFiles)
    File.Delete(file);

globalStartPage, her kümedeki ilk indeksin türevinden alınır, bu yüzden FirstPageNumber, önceki parçanın bıraktığı yerden tam olarak devam eder.

Notlar ve Sınırlamalar

  • Sürekli numaralandırma: FirstPageNumber, sayfa numaralarını parçalar arasında taşıyan şeydir. Bu olmadan, her parça sayfa 1'den başlar.
  • Parça boyutu ayarlanabilir: 300 başlangıç noktasıdır; parçanın faydalı olmaya başladığı boyut, iş yüküne bağlıdır.
  • Birleştirme bir geçiş ekler: toplam süre, parça başına render süresinin toplamı artı son birleştirme.
  • Çok büyük işler: Birleştirme sırasında periyodik olarak çöp toplamayı zorlamak ve tarayıcı havuzunu ayarlamak (BrowserPool.MaxIdleTabs, MaxDynamicHFPagesPerBatch) belleği kontrol altında tutmada yardımcı olabilir.

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ı