Cabeçalhos e Rodapés em PDFs Grandes em Fragmentos

Curtis Chau
Curtis Chau
Atualizado: 21 de agosto de 2026

Adicionar cabeçalhos e rodapés a um PDF muito grande de uma só vez pode ser lento. Processe o documento em fragmentos de páginas de tamanho fixo, depois mescle os resultados, para reduzir o tempo de renderização enquanto mantém os números das páginas contínuos em todo o documento.

Solução

1. Divida os índices de página em lotes

Escolha um tamanho de fragmento e agrupe os índices de páginas do documento em lotes de tamanho fixo (300 páginas cada abaixo). Isso decide quantas páginas cada passagem de renderização precisa lidar.

2. Copie cada lote em seu próprio documento

Extraia as páginas para o lote atual usando CopyPages, para que cada fragmento seja um PdfDocument independente.

3. Adicione cabeçalhos e rodapés com numeração contínua

Defina FirstPageNumber para a página inicial do fragmento. Isso mantém os números de página correndo por todo o documento, em vez de reiniciarem em 1 em cada fragmento.

4. Salve cada pedaço e descarte-o

Escreva cada fragmento para um arquivo temporário e descarte-o. Liberar o fragmento antes do próximo lote mantém a memória sob controle.

5. Mescle os fragmentos e salve o PDF final

Reabra os arquivos temporários, adicione-os em ordem com AppendPdf, salve o resultado e, em seguida, exclua os arquivos temporários.

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 é derivado do primeiro índice em cada lote, então FirstPageNumber continua exatamente de onde o fragmento anterior parou.

Notas e Limitações

  • Numeração contínua: FirstPageNumber é o que mantém os números das páginas através dos fragmentos. Sem isso, cada fragmento reinicia na página 1.
  • O tamanho do fragmento é ajustável: 300 é um ponto de partida; o tamanho em que a fragmentação começa a compensar depende da carga de trabalho.
  • Mesclar adiciona uma passagem: o tempo total é a soma da renderização por fragmento mais a mesclagem final.
  • Trabalhos muito grandes: forçar periodicamente a coleta de lixo durante a mesclagem e ajustar o pool do navegador (BrowserPool.MaxIdleTabs, MaxDynamicHFPagesPerBatch) pode ajudar a manter a memória sob controle.

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia Mais

Pronto para começar?

Downloads no NuGet 22,198,312Versão:2026.11recém-lançado