Kopf- und Fußzeilen bei großen PDFs in Teilen

Curtis Chau
Curtis Chau
Aktualisiert: 21. August 2026

Das Hinzufügen von Kopf- und Fußzeilen zu einem sehr großen PDF in einem Durchgang kann langsam sein. Verarbeiten Sie das Dokument in festen Seitengrößen, und fügen Sie anschließend die Ergebnisse zusammen, um die Renderzeit zu reduzieren und gleichzeitig die Seitennummerierung über das gesamte Dokument hinweg fortlaufend zu halten.

Lösung

1. Teilen Sie die Seitenindizes in Chargen auf

Wählen Sie eine Stückgröße und gruppieren Sie die Seitenindizes des Dokuments in feste Batch-Größen (jeweils 300 Seiten unten). Dies entscheidet, wie viele Seiten jeder Rendervorgang bewältigen muss.

2. Kopieren Sie jede Charge in ein eigenes Dokument

Extrahieren Sie die Seiten für das aktuelle Batch mit CopyPages, sodass jedes Stück ein unabhängiges PdfDocument ist.

3. Kopf- und Fußzeilen mit fortlaufender Nummerierung hinzufügen

Setzen Sie FirstPageNumber auf die Startseite des Stücks. Das hält die Seitennummerierung über das gesamte Dokument hinweg, anstatt bei jedem Stück bei 1 neu zu starten.

4. Speichern Sie jeden Abschnitt und setzen Sie ihn frei

Schreiben Sie jedes Stück in eine temporäre Datei und geben Sie es frei. Das Freigeben des Stücks vor dem nächsten Batch hält den Speicherverbrauch in Schach.

5. Die Stücke zusammenführen und das endgültige PDF speichern

Öffnen Sie die temporären Dateien erneut, fügen Sie sie der Reihe nach mit AppendPdf an, speichern Sie das Ergebnis und löschen Sie dann die temporären Dateien.

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 wird aus dem ersten Index in jedem Batch abgeleitet, sodass FirstPageNumber genau dort fortsetzt, wo das vorherige Stück aufhört.

Hinweise und Einschränkungen

  • Fortlaufende Nummerierung: FirstPageNumber ist das, was die Seitennummerierung über die Stücke trägt. Ohne sie startet jedes Stück bei Seite 1 neu.
  • Die Stückgröße ist anpassbar: 300 ist ein Ausgangspunkt; die Größe, bei der sich das Stückeln lohnt, hängt von der Arbeitsbelastung ab.
  • Zusammenführen fügt einen Vorgang hinzu: die Gesamtzeit ist die Summe aus der pro Stück-Renderzeit plus dem endgültigen Zusammenführen.
  • Sehr große Aufträge: das periodische Erzwingen der Speicherbereinigung während des Zusammenführens und das Anpassen des Browserpools (BrowserPool.MaxIdleTabs, MaxDynamicHFPagesPerBatch) kann helfen, den Speicherverbrauch zu kontrollieren.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 22,198,312Version:2026.11gerade veröffentlicht