Agregar encabezados y pies de página en PDF usando C## y IronPDF
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.
-
1Instalar IronPDF con NuGet Package Manager
-
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");Dim renderer As New IronPdf.ChromePdfRenderer With { .RenderingOptions = New IronPdf.RenderingOptions With { .TextHeader = New IronPdf.TextHeaderFooter With { .CenterText = "Report • {date}" }, .TextFooter = New IronPdf.TextHeaderFooter With { .RightText = "Page {page} of {total-pages}" } } } renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>").SaveAs("withHeadersFooters.pdf")Dim renderer As New IronPdf.ChromePdfRenderer With { .RenderingOptions = New IronPdf.RenderingOptions With { .TextHeader = New IronPdf.TextHeaderFooter With { .CenterText = "Report • {date}" }, .TextFooter = New IronPdf.TextHeaderFooter With { .RightText = "Page {page} of {total-pages}" } } } renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>").SaveAs("withHeadersFooters.pdf") -
3Despliegue para probar en su entorno real
Empiece a usar IronPDF en su proyecto hoy con una prueba gratuita
Flujo de trabajo mínimo (5 pasos)
- Descargue la biblioteca C# para añadir encabezados y pies de página
- Carga un PDF existente o renderiza uno nuevo
- Utilice los métodos
AddTextHeadersyAddTextFooterspara añadir encabezados y pies de página de texto - Utilice los métodos
AddHtmlHeadersyAddHtmlFooterspara añadir encabezados y pies de página HTML - Añada encabezados y pies de página en el momento de la renderización configurando las
RenderingOptions
¿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");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");Imports IronPdf
' Instantiate renderer and create PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
' Create text header
Dim textHeader As New TextHeaderFooter With {
.CenterText = "This is the header!"
}
' Create text footer
Dim textFooter As New TextHeaderFooter With {
.CenterText = "This is the footer!"
}
' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)
pdf.SaveAs("addTextHeaderFooter.pdf")Imports IronPdf
' Instantiate renderer and create PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
' Create text header
Dim textHeader As New TextHeaderFooter With {
.CenterText = "This is the header!"
}
' Create text footer
Dim textFooter As New TextHeaderFooter With {
.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");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");Imports IronPdf
' Instantiate renderer
Dim renderer As New ChromePdfRenderer()
' Create header and add to rendering options
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
.CenterText = "This is the header!"
}
' Create footer and add to rendering options
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
.CenterText = "This is the footer!"
}
' Render PDF with header and footer
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
pdf.SaveAs("renderWithTextHeaderFooter.pdf")Imports IronPdf
' Instantiate renderer
Dim renderer As New ChromePdfRenderer()
' Create header and add to rendering options
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
.CenterText = "This is the header!"
}
' Create footer and add to rendering options
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
.CenterText = "This is the footer!"
}
' Render PDF with header and footer
Dim pdf As PdfDocument = 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
};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
};Imports IronPdf
Imports IronPdf.Font
Imports IronSoftware.Drawing
' Create text header
Private textHeader As New TextHeaderFooter With {
.CenterText = "Center text",
.LeftText = "Left text",
.RightText = "Right text",
.Font = IronSoftware.Drawing.FontTypes.ArialBoldItalic,
.FontSize = 16,
.DrawDividerLine = True,
.DrawDividerLineColor = Color.Red
}Imports IronPdf
Imports IronPdf.Font
Imports IronSoftware.Drawing
' Create text header
Private textHeader As New TextHeaderFooter With {
.CenterText = "Center text",
.LeftText = "Left text",
.RightText = "Right text",
.Font = IronSoftware.Drawing.FontTypes.ArialBoldItalic,
.FontSize = 16,
.DrawDividerLine = True,
.DrawDividerLineColor = Color.Red
}Resultado
El texto izquierdo, central y derecho se renderizan con sus fuentes configuradas, y una línea divisoria coloreada se encuentra debajo de ellos.

¿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 mmusing 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 mmImports IronPdf
' Instantiate renderer and create PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
Dim header As New TextHeaderFooter With {
.CenterText = "This is the header!"
}
Dim footer As New TextHeaderFooter With {
.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 mmImports IronPdf
' Instantiate renderer and create PDF
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
Dim header As New TextHeaderFooter With {
.CenterText = "This is the header!"
}
Dim footer As New TextHeaderFooter With {
.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>");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>");Imports IronPdf
' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private header As New TextHeaderFooter With {.CenterText = "This is the header!"}
Private footer As New TextHeaderFooter With {.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
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")Imports IronPdf
' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private header As New TextHeaderFooter With {.CenterText = "This is the header!"}
Private footer As New TextHeaderFooter With {.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
Dim pdf As PdfDocument = 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");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");Imports IronPdf
Private renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
.HtmlFragment = "<div style='background-color: #4285f4; color: white; padding: 15px; text-align: center;'>
<h1>Example header</h1> <br>
<p>Header content</p>
</div>",
.MaxHeight = HtmlHeaderFooter.FragmentHeight
}
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")
pdf.SaveAs("dynamicHeaderSize.pdf")Imports IronPdf
Private renderer As New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
.HtmlFragment = "<div style='background-color: #4285f4; color: white; padding: 15px; text-align: center;'>
<h1>Example header</h1> <br>
<p>Header content</p>
</div>",
.MaxHeight = HtmlHeaderFooter.FragmentHeight
}
Dim pdf As PdfDocument = 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.
¿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 etiquetatitleen 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}",
};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}",
};Imports IronPdf
' Create header and footer
Private textHeader As New TextHeaderFooter With {
.CenterText = "{page} of {total-pages}",
.LeftText = "Today's date: {date}",
.RightText = "The time: {time}"
}
Private textFooter As New TextHeaderFooter With {
.CenterText = "Current URL: {url}",
.LeftText = "Title of the HTML: {html-title}",
.RightText = "Title of the PDF: {pdf-title}"
}Imports IronPdf
' Create header and footer
Private textHeader As New TextHeaderFooter With {
.CenterText = "{page} of {total-pages}",
.LeftText = "Today's date: {date}",
.RightText = "The time: {time}"
}
Private textFooter As New TextHeaderFooter With {
.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);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);Imports IronPdf
Private headerHtml As String = "
<html>
<head>
<link rel='stylesheet' href='style.css'>
</head>
<body>
<h1>This is a header!</h1>
</body>
</html>"
Private footerHtml As String = "
<html>
<head>
<link rel='stylesheet' href='style.css'>
</head>
<body>
<h1>This is a footer!</h1>
</body>
</html>"
' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
' Create header and footer
Private htmlHeader As New HtmlHeaderFooter With {
.HtmlFragment = headerHtml,
.LoadStylesAndCSSFromMainHtmlDocument = True
}
Private htmlFooter As New HtmlHeaderFooter With {
.HtmlFragment = footerHtml,
.LoadStylesAndCSSFromMainHtmlDocument = True
}
' Add to PDF
pdf.AddHtmlHeaders(htmlHeader)
pdf.AddHtmlFooters(htmlFooter)Imports IronPdf
Private headerHtml As String = "
<html>
<head>
<link rel='stylesheet' href='style.css'>
</head>
<body>
<h1>This is a header!</h1>
</body>
</html>"
Private footerHtml As String = "
<html>
<head>
<link rel='stylesheet' href='style.css'>
</head>
<body>
<h1>This is a footer!</h1>
</body>
</html>"
' Instantiate renderer and create PDF
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
' Create header and footer
Private htmlHeader As New HtmlHeaderFooter With {
.HtmlFragment = headerHtml,
.LoadStylesAndCSSFromMainHtmlDocument = True
}
Private htmlFooter As New HtmlHeaderFooter With {
.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);// Add to PDF
pdf.AddHtmlHeaders(header, 0, 0, 0);
pdf.AddHtmlFooters(footer, 0, 0, 0);' Add to PDF
pdf.AddHtmlHeaders(header, 0, 0, 0)
pdf.AddHtmlFooters(footer, 0, 0, 0)' 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.
ContentOverlapBehavior | Comportamiento |
|---|---|
Ignore | No hay verificación de solapamiento; el encabezado/pie de página se estampa tal como está. Este es el predeterminado. |
Warn | Registra una advertencia que lista los índices de página afectados, y aún así añade el encabezado/pie de página. |
Throw | Lanza 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");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");Imports IronPdf
' Start from an existing PDF (rendered here for the example)
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Line items and totals...</p>")
' A fixed MaxHeight is required for overlap detection to run
Dim footer As New HtmlHeaderFooter With {
.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")Imports IronPdf
' Start from an existing PDF (rendered here for the example)
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Invoice</h1><p>Line items and totals...</p>")
' A fixed MaxHeight is required for overlap detection to run
Dim footer As New HtmlHeaderFooter With {
.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.
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.