Cómo añadir números de página en PDF usando C#

Introducción

Los números de página en los PDF informan a los lectores del índice del documento para que puedan localizar una página concreta. También ayudan a los lectores a organizarse, rellenar formularios o prepararse para reuniones u otras interacciones. La biblioteca IronPDF C# ofrece funciones de edición de PDF mediante programación. En este artículo, IronPDF se utilizará para añadir números de página a documentos PDF.

IronPDF: Biblioteca C

La biblioteca IronPDF C# es un conjunto completo de funciones personalizadas específicas de PDF que se agrupan en una única API simplificada. Con su conjunto de efectos listos para usar, diseños y mucho más, ha llegado el momento de que los desarrolladores .NET den nueva vida a sus creaciones PDF. La biblioteca IronPDF C# promete cambiar esta situación haciendo que la creación de PDF sea rápida y sencilla, al tiempo que se ahorra tiempo y dinero.

Veamos cómo añadir números de página a un documento PDF utilizando la biblioteca IronPDF C#.

Crear o abrir un proyecto C

Este tutorial utilizará la última versión de Visual Studio. Debe tener instalado .NET Framework en su equipo, ya que es necesario para ejecutar la biblioteca IronPDF. Siga los pasos indicados para crear el proyecto C#:

• Abrir Visual Studio

  

  Visual Studio abriendo ui

• Haga clic en el botón "Crear un nuevo proyecto".

  

  Crea un nuevo proyecto en Visual Studio.

• Seleccione C# Console Application de las plantillas de proyecto y haga clic en el botón Next. Ahora dale un nombre al proyecto y haz clic en el botón Siguiente.

  

  Configura tu nuevo proyecto

• A continuación, seleccione .NET Framework. Se recomienda la última versión. A continuación, haga clic en el botón Crear. Creará el proyecto C#.

  

  El proyecto creado con un archivo Program.cs vacío

  El proyecto C# ya está creado. La biblioteca IronPDF también puede añadirse como referencia a cualquier proyecto C# existente. Basta con abrir el proyecto e instalar la biblioteca IronPDF. La siguiente sección mostrará cómo instalar la librería IronPDF en un proyecto .NET.

Instalar la biblioteca IronPDF

Hay muchas formas de instalar la biblioteca IronPDF:

• Uso de la consola del gestor de paquetes
• Uso del gestor de paquetes NuGet
• Por archivo DLL

Uso de la consola del gestor de paquetes

El método recomendado es utilizar la consola del gestor de paquetes. Siga los siguientes pasos para instalar IronPDF:

• Abra la consola del gestor de paquetes (situado normalmente en la parte inferior de Visual Studio).
• Escribe el siguiente comando en la consola.

Install-Package IronPdf

• Comenzará la instalación de la biblioteca. Verás el progreso en la consola.

• Tras la instalación, podrá utilizar la biblioteca IronPDF en su proyecto.

  

  El progreso de la instalación del paquete IronPdf en la pestaña Consola del Gestor de Paquetes

Uso del gestor de paquetes NuGet

Siga los pasos que se indican a continuación para instalar la biblioteca IronPDF mediante NuGet Package Manager:

• Abra el proyecto C# y vaya a Herramientas > Administrador de paquetes NuGet > Administrar paquetes NuGet para la solución.

  

  Navegue hasta el Gestor de paquetes NuGet.

• Se abrirá la ventana del gestor de paquetes NuGet. Haga clic en el menú Examinar. Después, escriba IronPDF en la barra de búsqueda. Selecciona la primera.

  

  Instalar el paquete IronPdf utilizando NuGet Package Manager

  Haga clic en el botón Instalar. Instalará la librería IronPDF y el proyecto estará listo para usarse con la librería IronPDF.

Por archivo DLL

También puede descargar directamente la DLL. Después de descargar el archivo, añada una referencia al proyecto. Visite nuestra página de documentación oficial para ver un tutorial de instalación más detallado.

La instalación ha finalizado. Es hora de escribir el código para añadir números de página al archivo PDF. Esto funciona tanto para documentos PDF nuevos como existentes. Veamos cómo se hace.

Añadir números de página en el documento PDF

Ahora es el momento de añadir los números de página a un nuevo documento. En primer lugar, debe añadirse el espacio de nombres IronPdf. Añade el siguiente código en la parte superior del archivo de código:

using IronPdf;

using IronPdf;

Imports IronPdf

Ahora añade el siguiente fragmento de código en el método principal del proyecto:

var html = @"
<p> Hello Iron</p>
<p> This is 1st Page </p>
<div style = 'page-break-after: always;' ></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;' ></div>
<p> This is 3rd Page</p>";

var Renderer = new ChromePdfRenderer();

Renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{

    MaxHeight = 15, //milímetros
    HtmlFragment = "<center><i>{page} of {total-pages}<i></center>",
    DrawDividerLine = true
};

using var pdfdoc = Renderer.RenderHtmlAsPdf(html);
pdfdoc.SaveAs("pageNumber.pdf");

var html = @"
<p> Hello Iron</p>
<p> This is 1st Page </p>
<div style = 'page-break-after: always;' ></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;' ></div>
<p> This is 3rd Page</p>";

var Renderer = new ChromePdfRenderer();

Renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{

    MaxHeight = 15, //milímetros
    HtmlFragment = "<center><i>{page} of {total-pages}<i></center>",
    DrawDividerLine = true
};

using var pdfdoc = Renderer.RenderHtmlAsPdf(html);
pdfdoc.SaveAs("pageNumber.pdf");

Dim html = "
<p> Hello Iron</p>
<p> This is 1st Page </p>
<div style = 'page-break-after: always;' ></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;' ></div>
<p> This is 3rd Page</p>"

Dim Renderer = New ChromePdfRenderer()

Renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
	.MaxHeight = 15,
	.HtmlFragment = "<center><i>{page} of {total-pages}<i></center>",
	.DrawDividerLine = True
}

Dim pdfdoc = Renderer.RenderHtmlAsPdf(html)
pdfdoc.SaveAs("pageNumber.pdf")

El siguiente ejemplo de código añade los números de página en un documento PDF recién creado. La funcionalidad "Encabezados y pies de página" de IronPDF permite combinar información sobre la numeración de las páginas.

Esto funciona tanto en HtmlHeaderFooters como en TextHeaderFooters: p.ej. {página} de {total-páginas}.

Si desea añadir un número de página a un archivo PDF existente, siga el código de ejemplo que aparece a continuación:

static void Main(string [] args)
{
    PdfDocument document = new PdfDocument("C:\\Users\\tayyabali.ashraf\\Downloads\\Xeem_App.pdf");
    var footer = new HtmlHeaderFooter();
    footer.MaxHeight = 15;
    footer.DrawDividerLine = true;
    footer.HtmlFragment = "<center><i>{page} of {total-pages}<i></center>";
    var allPageIndexes = Enumerable.Range(0, document.PageCount);
    document.AddHtmlFooters(footer, 1, allPageIndexes);
    document.SaveAs("Modified.pdf");
}

static void Main(string [] args)
{
    PdfDocument document = new PdfDocument("C:\\Users\\tayyabali.ashraf\\Downloads\\Xeem_App.pdf");
    var footer = new HtmlHeaderFooter();
    footer.MaxHeight = 15;
    footer.DrawDividerLine = true;
    footer.HtmlFragment = "<center><i>{page} of {total-pages}<i></center>";
    var allPageIndexes = Enumerable.Range(0, document.PageCount);
    document.AddHtmlFooters(footer, 1, allPageIndexes);
    document.SaveAs("Modified.pdf");
}

Shared Sub Main(ByVal args() As String)
	Dim document As New PdfDocument("C:\Users\tayyabali.ashraf\Downloads\Xeem_App.pdf")
	Dim footer = New HtmlHeaderFooter()
	footer.MaxHeight = 15
	footer.DrawDividerLine = True
	footer.HtmlFragment = "<center><i>{page} of {total-pages}<i></center>"
	Dim allPageIndexes = Enumerable.Range(0, document.PageCount)
	document.AddHtmlFooters(footer, 1, allPageIndexes)
	document.SaveAs("Modified.pdf")
End Sub

Salida

Los números de página se mostrarán así en el documento editado.

Número de página en el archivo PDF modificado

Aparte de esto, IronPDF ofrece muchas más funciones avanzadas para interactuar con archivos PDF, incluyendo extraer texto y contenido de un PDF, representación de gráficos en PDF, e incluso gestión de formularios PDF mediante programación. Todo esto puede aplicarse fácilmente mediante la página de muestras de código.

Conclusión

Este tutorial demostró cómo IronPDF ayuda a los desarrolladores a personalizar PDFs muy fácilmente con funciones simples y cortas, dirigidas tanto a nuevos documentos PDF como a documentos PDF existentes, no hay limitaciones. IronPDF es totalmente gratuito para fines de desarrollo. Puede comprobarlo usted mismo activando el prueba gratuita sin ninguna información de pago. Además, IronPDF tiene actualmente una oferta: puede adquirir cinco paquetes de Iron Software por el precio de sólo dos.! Encontrará más información sobre las distintas licencias en enlace.