Cómo añadir números de página a un PDF utilizando C#

¿Cómo añadir números de página básicos a un PDF?

Utilizando las cadenas de marcador de posición {page} y {total-pages} con la clase TextHeaderFooter o la clase HtmlHeaderFooter, puede añadir el número de página actual y el recuento total de páginas. Esta funcionalidad es esencial a la hora de crear nuevos PDF o convertir HTML a PDF documentos que requieran un formato profesional.

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-basic.cs

using IronPdf;

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter()
{
    CenterText = "{page} of {total-pages}"
};

// Create html footer
HtmlHeaderFooter htmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"
};

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

// Add header and footer
pdf.AddTextHeaders(textHeader);
pdf.AddHtmlFooters(htmlFooter);

pdf.SaveAs("pdfWithPageNumber.pdf");

El PDF de salida del código anterior se muestra a continuación:

También puede añadir encabezados y pies de página con cadenas de marcadores de posición de números de página directamente a las opciones de representación del ChromePdfRenderer. Este enfoque es útil cuando se trabaja con opciones de renderizado para personalizar el resultado PDF.

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-chromerenderer.cs

using IronPdf;

// Add header and footer to rendering options
ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
{
    CenterText = "{page} of {total-pages}"
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"
};

string html = @"
    <h1>Hello World!</h1>
<div style='page-break-after: always;'/>
    <h1>2nd Page!</h1>";

// Render new PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

pdf.SaveAs("applyPageNumberWithRenderingOptions.pdf");

Cuando trabaje con documentos complejos, tenga en cuenta los saltos de página y los márgenes personalizados para garantizar que los números de página se muestren correctamente.

¿Cómo puedo añadir números de página solo a determinadas páginas?

Con IronPDF, puede controlar dónde aparecen los números de página. Haz que empiecen en una página específica o que se apliquen a grupos concretos como las páginas indexadas pares. Esta flexibilidad es valiosa a la hora de generar informes en PDF o trabajar con documentos que contengan diferentes secciones.

En primer lugar, prepare el documento PDF para aplicar números de página:

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-preparation.cs

using IronPdf;
using System.Linq;
using System.Collections.Generic;

string multi_page_html = @"
    <p>This is the 1st Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 2nd Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 3rd Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 4th Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 5th Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 6th Page</p>
<div style = 'page-break-after: always;' ></div>
    <p>This is the 7th Page</p>";

// Create header
HtmlHeaderFooter header = new HtmlHeaderFooter()
{
    HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"
};

// Render PDF
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf(multi_page_html);

// Create a Page Range 0..6
var allPageIndices = Enumerable.Range(0, pdf.PageCount);

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-even-pages.cs

// Get even page indexes (resulting in odd page numbers)
var evenPageIndices = allPageIndices.Where(i => i % 2 == 0);

pdf.AddHtmlHeaders(header, 1, evenPageIndices);
pdf.SaveAs("EvenPages.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-odd-pages.cs

// Get odd page indexes (resulting in even page numbers)
var oddPageIndexes = allPageIndices.Where(i => i % 2 != 0);

pdf.AddHtmlHeaders(header, 1, oddPageIndexes);
pdf.SaveAs("OddPages.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-last-page-only.cs

// Last page only
var lastPageIndex = new List<int>() { pdf.PageCount - 1 };

pdf.AddHtmlHeaders(header, 1, lastPageIndex);
pdf.SaveAs("LastPageOnly.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-first-page-only.cs

// First page only
var firstPageIndex = new List<int>() { 0 };

pdf.AddHtmlHeaders(header, 1, firstPageIndex);
pdf.SaveAs("FirstPageOnly.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page.cs

// Skip the first page
var skipFirstPage = allPageIndices.Skip(1);

pdf.AddHtmlHeaders(header, 1, skipFirstPage);
pdf.SaveAs("SkipFirstPage.pdf");

:path=/static-assets/pdf/content-code-examples/how-to/page-numbers-skip-first-page-and-dont-count-it.cs

// Skip the first page and start numbering the second page as page 1
var skipFirstPageAndDontCountIt = allPageIndices.Skip(1);

pdf.AddHtmlHeaders(header, 0, skipFirstPageAndDontCountIt);
pdf.SaveAs("SkipFirstPageAndDontCountIt.pdf");

Técnicas avanzadas de numeración de páginas

Además de la numeración de páginas básica, IronPDF admite escenarios avanzados, entre los que se incluyen:

• Numeración por secciones: Diferentes esquemas de numeración para las distintas secciones del documento
• Números romanos: Formato personalizado para páginas de prefacio o apéndice
• Múltiples sistemas de numeración: Combinación de diferentes estilos de numeración en un mismo documento
• Conteo dinámico de páginas: Actualización del recuento total de páginas al añadir o copiar páginas

Estas técnicas resultan muy útiles a la hora de crear documentos complejos, como manuales técnicos, artículos académicos o documentos jurídicos que requieran sofisticados esquemas de numeración de páginas.

Mejores prácticas para los números de página

A la hora de implementar números de página en sus PDF, tenga en cuenta estas prácticas:

1. Consistencia: Mantenga un posicionamiento y un formato coherentes en todo el documento
2. Lectura: Asegúrese de que los números de página sean claramente visibles y no se solapen con el contenido
3. Accesibilidad: Utiliza tamaños de letra y contrastes adecuados para facilitar la lectura
4. Aspecto profesional: Haga coincidir el estilo del número de página con el diseño general de su documento

Siguiendo estas directrices y aprovechando las flexibles funciones de numeración de páginas de IronPDF, podrá crear documentos PDF profesionales y bien organizados que cumplan sus requisitos específicos.