Agregar encabezados y pies de página en PDF usando C## y IronPDF

Curtis Chau
Curtis Chau
Actualizado: 3 de agosto de 2026

IronPDF te permite añadir fácilmente encabezados y pies de página a documentos PDF en C# usando métodos como AddTextHeaders y AddTextFooters para texto simple, o AddHtmlHeaders y AddHtmlFooters para contenido basado en HTML con soporte completo de estilo CSS. Esta potente funcionalidad es esencial para crear PDF profesionales con una marca, numeración de páginas y metadatos de documentos coherentes.

¿Necesita incluir números de página, un logo de la empresa o una fecha en la parte superior o inferior de cada página en un documento PDF? IronPDF simplifica la aplicación de encabezados y pies de página a archivos PDF en su proyecto de C#. Ya se trate de informes, facturas o cualquier otro documento comercial, los encabezados y pies de página son elementos cruciales de navegación e identificación que mejoran la usabilidad del documento.

Inicio rápido: Cómo agregar encabezados y pies de página a archivos PDF en C#

Agregue fácilmente encabezados y pies de página a sus documentos PDF usando IronPDF en C#. Esta guía muestra cómo aplicar encabezados y pies de página basados en texto con números de página y texto personalizado en cuestión de segundos. Utilice los métodos AddTextHeaders y AddTextFooters para mejorar rápidamente la presentación de su PDF. Guarde su PDF actualizado con un código mínimo, asegurando un acabado profesional a sus documentos.

  1. 1Instalar IronPDF con NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Copie y ejecute este fragmento de código.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { TextHeader = new IronPdf.TextHeaderFooter { CenterText = "Report • {date}" }, TextFooter = new IronPdf.TextHeaderFooter { RightText = "Page {page} of {total-pages}" } } }
        .RenderHtmlAsPdf("<h1>Hello World!</h1>")
        .SaveAs("withHeadersFooters.pdf");
  3. 3Despliegue para probar en su entorno real

    Empiece a usar IronPDF en su proyecto hoy con una prueba gratuita
    arrow pointer

¿Cómo añado un encabezado/pie de texto?

Para crear un encabezado/pie de página solo con texto, instancie un objeto TextHeaderFooter, agregue el texto deseado y añada el objeto a su PDF. La clase TextHeaderFooter proporciona una manera sencilla de añadir elementos de texto consistentes en todas las páginas de su documento. Este método es especialmente útil para encabezados y pies de página sencillos que no requieran un formato o estilo complejos.

using IronPdf;

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");

Resultado

Un encabezado y pie de página de texto centrado se estampa en la página renderizada.

¿Cómo puedo añadir encabezados/pies de página durante la renderización?

Alternativamente, puede añadir directamente un encabezado/pie de página usando RenderingOptions del renderizador. Esto añade el encabezado y el pie de página del texto durante el proceso de renderizado, lo que resulta más eficaz que añadirlos una vez creado el PDF. Este enfoque es recomendable cuando se conoce de antemano el contenido del encabezado y el pie de página, ya que reduce el tiempo de procesamiento y garantiza un formato coherente desde el principio.

using IronPdf;

// Instantiate renderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Create header and add to rendering options
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};


// Create footer and add to rendering options
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Render PDF with header and footer
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
pdf.SaveAs("renderWithTextHeaderFooter.pdf");

Resultado

El mismo encabezado y pie de página centrados, aplicados durante el renderizado a través de RenderingOptions.

¿Cómo puedo personalizar las propiedades del texto y del divisor?

En la clase TextHeaderFooter, puede establecer texto para las posiciones izquierda, centro y derecha. Además, puede personalizar el tipo de fuente y el tamaño del texto y agregar un divisor con un color personalizado configurando las propiedades relevantes. Estas opciones de personalización permiten crear encabezados y pies de página que se ajusten a la marca corporativa o a las directrices de estilo del documento. La función de línea divisoria es especialmente útil para crear una separación visual entre el encabezado/pie de página y el contenido principal.

using IronPdf;
using IronPdf.Font;
using IronSoftware.Drawing;

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "Center text", // Set the text in the center
    LeftText = "Left text", // Set left-hand side text
    RightText = "Right text", // Set right-hand side text
    Font = IronSoftware.Drawing.FontTypes.ArialBoldItalic, // Set font
    FontSize = 16, // Set font size
    DrawDividerLine = true, // Draw Divider Line
    DrawDividerLineColor = Color.Red, // Set color of divider line
};

Resultado

El texto izquierdo, central y derecho se renderizan con sus fuentes configuradas, y una línea divisoria coloreada se encuentra debajo de ellos.

Ejemplo de alineación de texto que muestra las opciones de posicionamiento del texto a la izquierda, al centro y a la derecha

¿Qué fuentes están disponibles por defecto?

Puede ver qué tipos de fuentes están disponibles por defecto en la Referencia de la API de IronPDF. IronPDF es compatible con una amplia gama de fuentes estándar, como Arial, Times New Roman, Helvetica, Courier y sus variantes. Si necesita fuentes personalizadas, obtenga más información sobre la gestión de fuentes en IronPDF.

¿Cómo definir los márgenes de los encabezados/pies de texto?

Por defecto, los encabezados y pies de página de IronPDF vienen con márgenes predefinidos. Si desea que el encabezado de texto abarque todo el ancho del documento PDF, especifique valores de margen de 0. Esto se puede lograr ya sea estableciendo los márgenes directamente en las funciones AddTextHeaders y AddTextFooters o a través de RenderingOptions en ChromePdfRenderer. Comprender el control de márgenes es crucial para lograr maquetaciones perfectas, especialmente cuando se trabaja con tamaños de papel personalizados.

using IronPdf;

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

TextHeaderFooter header = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

TextHeaderFooter footer = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

pdf.AddTextHeaders(header, 35, 30, 25); // Left Margin = 35, Right Margin  = 30, Top Margin = 25
pdf.AddTextFooters(footer, 35, 30, 25); // Margin values are in mm

¿Cómo aplico márgenes a través de las opciones de renderizado?

Si añade valores de margen en el RenderingOptions de ChromePdfRenderer, estos márgenes también se aplicarán al encabezado y pie de página. Este enfoque proporciona una forma centralizada de gestionar los márgenes en todo el documento, incluidos los encabezados, los pies de página y el contenido principal. Para una personalización más avanzada de los márgenes, consulta nuestra guía sobre la configuración de márgenes personalizados.

using IronPdf;

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();

TextHeaderFooter header = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

TextHeaderFooter footer = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Margin values are in mm
renderer.RenderingOptions.MarginRight = 30;
renderer.RenderingOptions.MarginLeft = 30;
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;

// Add header and footer to renderer
renderer.RenderingOptions.TextHeader = header;
renderer.RenderingOptions.TextFooter = footer;

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

Resultado

Los márgenes laterales de 30 mm y superiores e inferiores de 25 mm se aplican al encabezado, pie de página y cuerpo juntos.

¿Por qué debería evitar UseMarginsOnHeaderAndFooter?

La propiedad UseMarginsOnHeaderAndFooter en RenderingOptions no es adecuada para este caso de uso. Aplica los mismos valores de margen al encabezado, pie de página y contenido principal, lo que puede causar que el encabezado se superponga con el cuerpo del documento. Esta propiedad está principalmente destinada para aplicar encabezados y pies de página a PDFs existentes usando el método AddTextHeadersAndFooters. Para controlar mejor la maquetación, considere la posibilidad de utilizar saltos de página para gestionar el flujo de contenidos.

¿Qué es el dimensionamiento dinámico de márgenes?

Los márgenes estáticos planteaban un problema cuando el contenido de las cabeceras variaba de un documento a otro. Hubo que hacer ajustes no solo en los márgenes de cabecera y pie de página, sino también en el margen HTML principal para adaptarse a los distintos tamaños de cabecera y pie de página. En consecuencia, hemos implementado una función de dimensionamiento dinámico de los márgenes en la que la altura de la cabecera y el pie de página se ajustan dinámicamente en función del contenido, y el HTML principal se reposiciona en consecuencia. Esta función es especialmente útil cuando se trabaja con diseños CSS adaptables. Utilice el código siguiente para probar esta función:

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = @"<div style='background-color: #4285f4; color: white; padding: 15px; text-align: center;'>
                    <h1>Example header</h1> <br>
                    <p>Header content</p>
                    </div>",
    // Enable the dynamic height feature
    MaxHeight = HtmlHeaderFooter.FragmentHeight,
};

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");
pdf.SaveAs("dynamicHeaderSize.pdf");

Resultado

El encabezado HTML azul se expande para ajustarse a su contenido y el cuerpo se desplaza hacia abajo para dejar espacio.

Mi biblioteca favorita de este tipo es IronPDF. Permite una manipulación rápida y eficiente de archivos PDF. También tiene muchas funciones valiosas, como exportar al formato PDF/A y firmar documentos PDF digitalmente.

Milan Jovanovic

Microsoft MVP

Ver estudio de caso

IronOCR significa que podemos ahorrar $40,000 anualmente en el procesamiento manual, mientras mejoramos la productividad y liberamos recursos para tareas de alto impacto. Lo recomendaría encarecidamente.

Brent Matzelle

Director de Tecnología, OPYN

Ver estudio de caso

¿Cómo añado metadatos a los encabezados/pies de texto?

Puede añadir fácilmente metadatos como números de página, fecha y título del PDF incorporando cadenas de marcadores de posición en el texto. Estos marcadores de posición se sustituyen automáticamente por los valores correspondientes al renderizar el PDF. Esta función es esencial para crear encabezados y pies de página dinámicos que se actualicen automáticamente en función de las propiedades del documento. Aquí están todas las opciones de metadatos disponibles:

  • {page}: Número de página actual.
  • {total-pages}: Número total de páginas.
  • {url}: URL web desde la cual se renderizó el documento PDF.
  • {date}: Fecha actual.
  • {time}: Hora actual.
  • {html-title}: Título HTML especificado en la etiqueta title en HTML.
  • {pdf-title}: Título PDF especificado en los metadatos del PDF.

¿Qué marcadores de posición debo utilizar con más frecuencia?

Para aprender más sobre {page} y {total-pages}, visite la Guía de Números de Página de IronPDF. Estos marcadores de posición son los más comúnmente usados ya que proporcionan información de navegación esencial. Los marcadores de fecha y hora son especialmente útiles para documentos que necesitan un seguimiento de la fecha y hora, como informes o facturas.

using IronPdf;

// Create header and footer
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "{page} of {total-pages}",
    LeftText = "Today's date: {date}",
    RightText = "The time: {time}",
};

TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "Current URL: {url}",
    LeftText = "Title of the HTML: {html-title}",
    RightText = "Title of the PDF: {pdf-title}",
};

Este encabezado y pie de página llevan todos los marcadores de posición disponibles. Cada uno se resuelve a su valor en vivo cuando se renderiza el PDF, así que la página muestra su número y total, la fecha y hora, la URL de origen, y tanto los títulos HTML como PDF.

¿Cómo añado encabezados/pies de página HTML?

Puede personalizar aún más su encabezado/pie de página utilizando HTML y CSS. Para crear un encabezado/pie de página HTML, use la clase HtmlHeaderFooter. Este enfoque ofrece la máxima flexibilidad, ya que permite incluir imágenes, diseños complejos y contenido con estilo en los encabezados y pies de página. Si desea conservar los estilos CSS de una hoja de estilo CSS, establezca LoadStylesAndCSSFromMainHtmlDocument = true en las propiedades de la clase. Esto resulta especialmente útil cuando se trabaja con fuentes e iconos web.

using IronPdf;

string headerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a header!</h1>
    </body>
    </html>";

string footerHtml = @"
    <html>
    <head>
        <link rel='stylesheet' href='style.css'>
    </head>
    <body>
        <h1>This is a footer!</h1>
    </body>
    </html>";

// Instantiate renderer and create PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create header and footer
HtmlHeaderFooter htmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = headerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

HtmlHeaderFooter htmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = footerHtml,
    LoadStylesAndCSSFromMainHtmlDocument = true,
};

// Add to PDF
pdf.AddHtmlHeaders(htmlHeader);
pdf.AddHtmlFooters(htmlFooter);

Resultado

Encabezados y pies de página HTML renderizados a partir de fragmentos HtmlHeaderFooter.

¿Cómo controlo los márgenes del encabezado/pie de página HTML?

Similar a los encabezados y pies de página de texto, los métodos AddHtmlHeaders y AddHtmlFooters tienen márgenes predefinidos aplicados a ellos. Para aplicar márgenes personalizados, use una sobrecarga de las funciones con los valores de margen especificados. Para abarcar todo el contenido sin márgenes, establezca los márgenes en la función de sobrecarga en 0. Este nivel de control es esencial a la hora de crear documentos profesionales con requisitos de maquetación específicos.

// Add to PDF
pdf.AddHtmlHeaders(header, 0, 0, 0);
pdf.AddHtmlFooters(footer, 0, 0, 0);

Pasar 0 para los argumentos de margen hace que el encabezado y pie de página HTML abarquen todo el ancho de la página sin sangría.

¿Cómo detecto si un encabezado/pie de página se solapa con el contenido existente?

Cuando añade un encabezado o pie de página HTML a un PDF existente, IronPDF puede verificar si la banda de encabezado/pie de página se solaparía con contenido ya en la página, y advertir o lanzar un error. Pase un ContentOverlapBehavior a las sobrecargas AddHtmlHeaders/AddHtmlFooters, o establézcalo en tiempo de renderizado con RenderingOptions.HeaderFooterOverlapBehavior.

ContentOverlapBehaviorComportamiento
IgnoreNo hay verificación de solapamiento; el encabezado/pie de página se estampa tal como está. Este es el predeterminado.
WarnRegistra una advertencia que lista los índices de página afectados, y aún así añade el encabezado/pie de página.
ThrowLanza InvalidOperationException antes de estampar, listando los índices de página afectados.
using IronPdf;

// Start from an existing PDF (rendered here for the example)
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Line items and totals...</p>");

// A fixed MaxHeight is required for overlap detection to run
HtmlHeaderFooter footer = new HtmlHeaderFooter
{
    HtmlFragment = "<div>Confidential</div>",
    MaxHeight = 25,
};

// Throw an InvalidOperationException if the footer would overlap existing page content
pdf.AddHtmlFooters(footer, ContentOverlapBehavior.Throw);

pdf.SaveAs("invoice-with-footer.pdf");

Resultado

El pie de página HTML Confidencial estampado debajo del contenido de la factura.

Advertencia: La detección de solapamiento es solo de reporte. Piénselo de esta manera: es una luz de advertencia para su diseño. Indica dónde un encabezado o pie de página se sentaría sobre el contenido existente, pero nunca mueve, refluye o cambia el tamaño de ese contenido, por lo que prevenir el solapamiento sigue siendo su responsabilidad. La detección cubre solo texto e imágenes; el contenido vectorial o de ruta como bordes de tablas y líneas gobernadas no se detecta, por lo que un Throw que no se dispara no es garantía de que la salida esté libre de solapamiento. También requiere un HtmlHeaderFooter.MaxHeight explícito. Sin uno, ese lado se autoajusta y se omite la detección de solapamiento para él.

¿Cuándo utilizar encabezados/pies de página de texto o HTML?

A la hora de decidir entre cabeceras/pies de página de texto o HTML, hay que tener en cuenta las ventajas y desventajas. Si prioriza un renderizado de PDF más rápido, opte por los encabezados/pies de página de texto. Si la personalización y el estilo son esenciales, elija encabezados/pies de página HTML. La diferencia de tiempo de renderizado entre las cabeceras/pies de página de texto y HTML es mínima cuando las cabeceras/pies de página HTML tienen un contenido limitado. Sin embargo, aumenta a medida que aumenta el tamaño y el número de activos en las cabeceras/pies de página HTML.

¿Cuáles son las implicaciones para el rendimiento?

Las cabeceras y pies de página de texto se renderizan más rápido porque no requieren el análisis sintáctico de HTML ni el procesamiento de CSS. Las cabeceras/pies de página HTML ofrecen más flexibilidad, pero requieren un tiempo de renderizado adicional proporcional a su complejidad. Cuando se trabaja con documentos de gran tamaño o procesamiento por lotes, la diferencia de rendimiento se hace más notable. Para obtener un rendimiento óptimo en situaciones de gran volumen, tenga en cuenta nuestra guía sobre la generación asíncrona de PDF.

¿Listo para ver qué más puedes hacer? Consulte nuestra página de tutoriales aquí: Crear PDF

Preguntas frecuentes

¿Cómo puedo añadir encabezados y pies de página a un PDF usando C# e IronPDF?

Puede añadir encabezados y pies de página a un PDF usando IronPDF empleando métodos como AddTextHeaders y AddTextFooters para texto simple, o AddHtmlHeaders y AddHtmlFooters para incluir contenido HTML con soporte completo de estilado CSS.

¿Qué métodos están disponibles para añadir encabezados y pies de página de texto en IronPDF?

En IronPDF, puede usar los métodos AddTextHeaders y AddTextFooters junto con RenderingOptions en ChromePdfRenderer para agregar encabezados y pies de página de texto. Esto le permite incluir números de página, fechas y otros metadatos de manera sencilla.

¿Cómo maneja IronPDF los encabezados y pies de página HTML?

IronPDF le permite añadir encabezados y pies de página HTML usando la clase HtmlHeaderFooter. Esto le permite personalizar encabezados y pies de página con imágenes, diseños complejos y contenido estilado, ofreciendo máxima flexibilidad.

¿Puedo personalizar las propiedades de los encabezados y pies de página de texto?

Sí, con la clase TextHeaderFooter de IronPDF, puede configurar propiedades como la alineación del texto (izquierda, centro, derecha), tipo y tamaño de fuente, e incluir líneas divisorias con colores personalizados para que coincidan con el estilo de su documento.

¿Cómo aplico márgenes a los encabezados y pies de página en IronPDF?

Los encabezados y pies de página de texto pueden tener márgenes personalizados usando diferentes sobrecargas de los métodos AddTextHeaders, AddTextFooters, AddHtmlHeaders y AddHtmlFooters, o configurando valores de margen en las RenderingOptions de ChromePdfRenderer.

¿Es posible detectar la superposición de encabezados y pies de página con contenido existente en IronPDF?

Sí, IronPDF puede verificar el solapamiento usando la opción ContentOverlapBehavior al añadir encabezados y pies de página. Esto le permite recibir advertencias, lanzar una excepción, o ignorar el solapamiento según sus necesidades.

¿Cuáles son las consideraciones de rendimiento al elegir entre encabezados y pies de página de texto y HTML?

Los encabezados y pies de página de texto se renderizan más rápido ya que no requieren análisis de HTML o procesamiento CSS, lo que los hace ideales para aplicaciones críticas de rendimiento. Los encabezados y pies de página HTML ofrecen mayor personalización pero pueden requerir un poco más de tiempo de procesamiento.

¿Cómo incluyo metadatos como números de página y fechas en los encabezados y pies de página?

IronPDF admite marcadores de posición de metadatos como {page}, {total-pages}, {date}, y {time} en encabezados y pies de página de texto, que se resuelven dinámicamente a valores presentes durante el renderizado del PDF.

¿Qué es el ajuste dinámico de margenes en IronPDF?

El ajuste dinámico de márgenes en IronPDF ajusta automáticamente la altura de los encabezados y pies de página según el contenido. Esta característica ayuda a acomodar contenido variado de encabezado/pie y asegura una integración suave con el cuerpo principal del documento.

¿Qué fuentes son compatibles por defecto para los encabezados y pies de página en IronPDF?

IronPDF admite una amplia gama de fuentes estándar como Arial, Times New Roman y Helvetica por defecto. Para ver la lista completa, consulta la referencia API de IronPDF para obtener los tipos de fuente disponibles.

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