Kopf- und Fußzeilen bei großen PDFs in Teilen
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);Imports IronPdf
Imports System.IO
Imports System.Linq
Dim pdf = PdfDocument.FromFile("input.pdf")
Dim headerHtml As String = "<div style='font-size:10px;'>Header</div>"
Dim footerHtml As String = "<div style='text-align:right;font-size:10px;'>Page {page} of {total-pages}</div>"
Dim chunkSize As Integer = 300
Dim pageChunks = Enumerable.Range(0, pdf.PageCount).GroupBy(Function(i) i \ chunkSize).[Select](Function(g) g.ToArray()).ToList()
Dim tempFiles = New List(Of String)()
For Each indexes In pageChunks
Dim chunkPdf = pdf.CopyPages(indexes)
Dim globalStartPage As Integer = indexes.First() + 1
chunkPdf.AddHtmlHeadersAndFooters(New ChromePdfRenderOptions With {
.FirstPageNumber = globalStartPage,
.HtmlHeader = New HtmlHeaderFooter With {.HtmlFragment = headerHtml, .MaxHeight = 40},
.HtmlFooter = New HtmlHeaderFooter With {.HtmlFragment = footerHtml, .MaxHeight = 40}
})
Dim tempFile As String = Path.GetTempFileName() & ".pdf"
chunkPdf.SaveAs(tempFile)
chunkPdf.Dispose()
tempFiles.Add(tempFile)
Next
' Merge the chunks back into one document.
Dim finalPdf = New PdfDocument(tempFiles.First())
For Each file In tempFiles.Skip(1)
Using part As New PdfDocument(file)
finalPdf.AppendPdf(part)
End Using
Next
finalPdf.SaveAs("output.pdf")
finalPdf.Dispose()
' Clean up temp files.
For Each file In tempFiles
File.Delete(file)
NextImports IronPdf
Imports System.IO
Imports System.Linq
Dim pdf = PdfDocument.FromFile("input.pdf")
Dim headerHtml As String = "<div style='font-size:10px;'>Header</div>"
Dim footerHtml As String = "<div style='text-align:right;font-size:10px;'>Page {page} of {total-pages}</div>"
Dim chunkSize As Integer = 300
Dim pageChunks = Enumerable.Range(0, pdf.PageCount).GroupBy(Function(i) i \ chunkSize).[Select](Function(g) g.ToArray()).ToList()
Dim tempFiles = New List(Of String)()
For Each indexes In pageChunks
Dim chunkPdf = pdf.CopyPages(indexes)
Dim globalStartPage As Integer = indexes.First() + 1
chunkPdf.AddHtmlHeadersAndFooters(New ChromePdfRenderOptions With {
.FirstPageNumber = globalStartPage,
.HtmlHeader = New HtmlHeaderFooter With {.HtmlFragment = headerHtml, .MaxHeight = 40},
.HtmlFooter = New HtmlHeaderFooter With {.HtmlFragment = footerHtml, .MaxHeight = 40}
})
Dim tempFile As String = Path.GetTempFileName() & ".pdf"
chunkPdf.SaveAs(tempFile)
chunkPdf.Dispose()
tempFiles.Add(tempFile)
Next
' Merge the chunks back into one document.
Dim finalPdf = New PdfDocument(tempFiles.First())
For Each file In tempFiles.Skip(1)
Using part As New PdfDocument(file)
finalPdf.AppendPdf(part)
End Using
Next
finalPdf.SaveAs("output.pdf")
finalPdf.Dispose()
' Clean up temp files.
For Each file In tempFiles
File.Delete(file)
NextglobalStartPage 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:
FirstPageNumberist 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.