Nagłówki i stopki na dużych plikach PDF w kawałkach
Dodawanie nagłówków i stopek do bardzo dużego pliku PDF w jednej operacji może być powolne. Przetworz dokument w kawałkach o stałej wielkości, następnie scal wyniki, aby skrócić czas renderowania, zachowując ciągłość numeracji stron w całym dokumencie.
Rozwiązanie
1. Podziel indeksy stron na partie
Wybierz rozmiar kawałka i pogrupuj indeksy stron dokumentu w partie o stałej wielkości (poniżej po 300 stron każda). To decyduje, ile stron musi obsłużyć każde podejście do renderowania.
2. Skopiuj każdą partię do osobnego dokumentu
Wyodrębnij strony dla bieżącej partii za pomocą CopyPages, aby każdy fragment był niezależnym PdfDocument.
3. Dodaj nagłówki i stopki z ciągłą numeracją
Ustaw FirstPageNumber na stronę początkową fragmentu. To utrzymuje numeracje stron w całym dokumencie, zamiast zaczynać od 1 w każdym fragmencie.
4. Zapisz każdą porcję i zutylizuj ją
Zapisz każdy fragment do pliku tymczasowego i usuń go. Zwolnienie fragmentu przed następną partą pomaga kontrolować pamięć.
5. Scal fragmenty i zapisz końcowy PDF
Ponownie otwórz pliki tymczasowe, dołącz je w kolejności przy użyciu AppendPdf, zapisz wynik, a następnie usuń pliki tymczasowe.
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 jest pochodną pierwszego indeksu w każdej partii, więc FirstPageNumber zaczyna dokładnie tam, gdzie poprzedni fragment się skończył.
Uwagi i ograniczenia
- Ciągła numeracja:
FirstPageNumberprzenosi numerację stron pomiędzy fragmentami. Bez tego każdy fragment zaczyna się od strony 1. - Rozmiar fragmentów jest regulowany: 300 to punkt wyjściowy; rozmiar, w którym fragmentacja zaczyna przynosić korzyści, zależy od obciążenia.
- Scalanie dodaje operację: całkowity czas to suma renderowania na kawałek plus końcowe scalanie.
- Bardzo duże zadania: okresowe wymuszanie zbierania śmieci podczas łączenia i dostosowywanie puli przeglądarek (
BrowserPool.MaxIdleTabs,MaxDynamicHFPagesPerBatch) może pomóc w utrzymaniu kontroli nad pamięcią.
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.