Encabezados y pies de página en PDFs grandes por partes

Curtis Chau
Curtis Chau
Actualizado: 21 de agosto de 2026

Agregar encabezados y pies de página a un PDF muy grande en una sola pasada puede ser lento. Procese el documento en fragmentos de páginas de tamaño fijo, luego fusione los resultados, para reducir el tiempo de renderizado mientras mantiene los números de página continuos en todo el documento.

Solución

1. Divida los índices de página en lotes

Elija un tamaño de fragmento y agrupe los índices de página del documento en lotes de tamaño fijo (300 páginas cada uno a continuación). Esto decide cuántas páginas tiene que manejar cada pasada de renderizado.

2. Copie cada lote en su propio documento

Extraiga las páginas para el lote actual con CopyPages de modo que cada fragmento sea un PdfDocument independiente.

3. Agregar encabezados y pies de página con numeración continua

Configure FirstPageNumber a la página inicial del fragmento. Eso mantiene los números de página corriendo a través de todo el documento en lugar de reiniciar en 1 en cada fragmento.

4. Guarde cada fragmento y deséchelo

Escriba cada fragmento a un archivo temporal y deséchelo. Liberar el fragmento antes del siguiente lote mantiene la memoria bajo control.

5. Fusionar los fragmentos y guardar el PDF final

Vuelva a abrir los archivos temporales, únalos en orden con AppendPdf, guarde el resultado y luego elimine los archivos temporales.

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 se deriva del primer índice en cada lote, por lo que FirstPageNumber continúa exactamente donde terminó el fragmento anterior.

Notas y limitaciones

  • Numeración continua: FirstPageNumber es lo que lleva los números de página a través de los fragmentos. Sin esto, cada fragmento reinicia en la página 1.
  • El tamaño del fragmento es ajustable: 300 es un punto de partida; el tamaño donde dividir en fragmentos comienza a ser rentable depende de la carga de trabajo.
  • La fusión añade una pasada: el tiempo total es la suma del renderizado por fragmento más la fusión final.
  • Trabajos muy grandes: forzar periódicamente la recolección de basura durante la fusión y ajustar el grupo del navegador (BrowserPool.MaxIdleTabs, MaxDynamicHFPagesPerBatch) puede ayudar a mantener la memoria bajo control.

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

Leer más

¿Listo para empezar?

Descargas de NuGet 22,198,312Versión:2026.11recién lanzado