Encabezado o pie de imagen sin crecimiento del tamaño del archivo

Curtis Chau
Curtis Chau
Actualizado: 29 de octubre de 2026

Agregar un logotipo Base64 a un encabezado o pie de página en un PDF puede inflar el archivo de salida, porque la imagen se re-embebe en cada página. Divida el encabezado o pie de página en una capa de imagen estática y una capa de texto dinámico para que la imagen se incruste una sola vez mientras el contenido por página se mantiene pequeño.

Solución

1. Divide el Encabezado o Pie en Dos Fragmentos HTML

Separe el contenido según la frecuencia con la que cambia. Coloque la imagen y cualquier texto que nunca cambie en un fragmento estático, y coloque el contenido por página como {page} en un fragmento dinámico. Dé a ambos fragmentos la misma disposición de tabla, con anchos de celda coincidentes, para que el texto dinámico caiga en la posición correcta sobre la capa estática.

2. Añade Primero el Fragmento Estático

Llame a AddHtmlHeadersAndFooters solo con el fragmento estático. La imagen Base64 se representa e incrusta una vez.

3. Añade el Fragmento Dinámico en una Segunda Pasada

Llame a AddHtmlHeadersAndFooters nuevamente solo con el fragmento dinámico. Esta pasada no contiene imagen, por lo que el contenido por página permanece pequeño. Renderizar las partes estática y dinámica juntas hace que el motor trate todo el HTML como dinámico y vuelva a incrustar la imagen en cada página, lo que causa que el archivo crezca.

using IronPdf;
var pdf = PdfDocument.FromFile("input.pdf");
// Static layer: holds the Base64 image. The page-number cell is left empty.
string staticFooter = @"
<table style='width:100%; table-layout:fixed;'>
  <tr>
    <td style='width:20%;'>
      <img src='data:image/png;base64,iVBORw0KGg...' style='width:150px;' />
    </td>
    <td style='width:80%; text-align:right;'></td>
  </tr>
</table>";
// Dynamic layer: holds only {page}. Same layout, but no image.
string dynamicFooter = $@"
<table style='width:100%; table-layout:fixed;'>
  <tr>
    <td style='width:20%;'></td>
    <td style='width:80%; text-align:right; font-size:10px;'>Page {{page}} of {pdf.PageCount}</td>
  </tr>
</table>";
// Pass 1: add the static image footer (image embedded once).
pdf.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
{
    HtmlFooter = new HtmlHeaderFooter { HtmlFragment = staticFooter, MaxHeight = 40 }
});
// Pass 2: add the dynamic page-number footer (no image, stays small).
pdf.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
{
    HtmlFooter = new HtmlHeaderFooter { HtmlFragment = dynamicFooter, MaxHeight = 40 }
});
pdf.SaveAs("output.pdf");

La primera pasada lleva la imagen Base64 en staticFooter; la segunda pasada lleva solo Page {page} of ... en dynamicFooter. Ambas tablas usan anchos de celda idénticos para que el número de página se alinee sobre la capa estática.

4. (Opcional) Referencia una Imagen Externa o SVG

Para reducir aún más el tamaño de salida, apunte la etiqueta <img> a un archivo de imagen externo o use un SVG en lugar de incrustar la imagen como una cadena Base64.

Notas y limitaciones

  • Se requiere diseño coincidente: ambos fragmentos deben compartir la misma estructura de tabla y anchos de celda, o el texto dinámico, como el número de página, no se alineará sobre la capa estática.
  • Más pequeño que Base64: un archivo de imagen externo o un SVG pueden reducir el tamaño del archivo más que una cadena Base64.
  • Encabezados también: la misma técnica se aplica a los encabezados. Mantenga la imagen en la pasada estática y coloque cualquier texto dinámico del encabezado en la segunda pasada.
Por favor, tenga en cuenta: Desde v2026.6.1, IronPDF maneja el encabezado y el pie de página por separado. Si la imagen está en el encabezado y {page} está solo en el pie de página, o viceversa, la imagen se incrusta una vez y no necesita dos pasadas. Use el método de dos pasadas mencionado anteriormente cuando la imagen y {page} estén en el mismo encabezado o el mismo pie de página.

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