Nagłówki i stopki na dużych plikach PDF w kawałkach

Curtis Chau
Curtis Chau
Zaktualizowano: 21 sierpnia 2026

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);

globalStartPage 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: FirstPageNumber przenosi 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.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 22,198,312Wersja:2026.11właśnie wydane