PDFsharp Añadir Números de Páginas a PDF VS IronPDF (Ejemplo)
El PDF (Formato de Documento Portátil) es un formato universalmente aceptado para compartir documentos a través de varias plataformas. Su capacidad para preservar el formato, las fuentes y el diseño lo hace indispensable para fines comerciales, legales y educativos. A medida que crece la necesidad de manipulación de PDF en el desarrollo de software, el ecosistema .NET proporciona a los desarrolladores múltiples bibliotecas para trabajar con PDFs. Entre ellas, PDFsharp e IronPDF se destacan como soluciones poderosas para la creación y manipulación de PDF.
Este artículo te mostrará cómo agregar números de página a documentos PDF utilizando PDFsharp e IronPDF en C#, y comparará las características de ambas bibliotecas para ayudarte a decidir cuál se adapta mejor a tus necesidades.
¿Qué es IronPDF?

IronPDF es una potente biblioteca .NET diseñada para la creación, manipulación y renderización sin problemas de PDF. Destaca por su capacidad para convertir HTML, CSS y JavaScript directamente en PDFs de alta calidad utilizando un motor basado en Chromium. Esto hace que IronPDF sea una solución ideal para desarrolladores que necesitan convertir páginas web dinámicas o contenido HTML complejo en un PDF bien formateado, preservando el diseño y el estilo tal como aparece en el navegador.
Características Clave de IronPDF:
- Convierte HTML, JavaScript y CSS a PDFs de alta calidad.
- Permite personalizar encabezados, pies de página, marcas de agua y otros elementos de página.
- Soporta fusión de archivos PDF y división de los mismos.
- Funciona sin problemas con aplicaciones .NET, incluidas las de los marcos ASP.NET y MVC.
- Proporciona un control preciso sobre la renderización de PDF, asegurando que el contenido se muestre como se pretende.
- Ofrece una API sencilla para una fácil integración en proyectos.
Para explorar características y ejemplos más avanzados, consulta la documentación oficial de IronPDF.
Instalación de IronPDF
Para agregar IronPDF a tu proyecto, utiliza el administrador de paquetes NuGet en Visual Studio. Puedes instalarlo usando la interfaz de línea de comandos visual o buscar directamente en el Administrador de Paquetes NuGet.
Instalación por línea de comandos:
Install-Package IronPdf
Alternativamente, puedes buscar "IronPDF" en el Administrador de Paquetes NuGet e instalarlo desde allí.
¿Qué es PDFSharp?
PDFsharp es una versátil biblioteca .NET centrada en la creación y manipulación de documentos PDF con alta flexibilidad. A diferencia de otras bibliotecas, PDFsharp permite un control detallado sobre la estructura y diseño de PDFs, lo que lo convierte en una excelente opción para desarrolladores que deseen crear documentos desde cero o modificar PDFs existentes. Con su rica API, PDFsharp soporta una amplia gama de tareas de manipulación de documentos, incluyendo la adición de texto, imágenes, tablas e incluso números de página.
Características Clave de PDFSharp:
- Crea, lee y modifica documentos PDF.
- Eventos de página personalizables para agregar elementos como números de página o pies de página.
- Soporta la adición de imágenes, texto, tablas y otros contenidos.
- Ofrece un control detallado sobre el diseño y estructura del PDF.
- Puede modificar PDFs existentes, incluidas la fusión o separación de documentos.
- Biblioteca de código abierto con flexibilidad para que los desarrolladores la personalicen o amplíen.
Para profundizar en la funcionalidad y uso de PDFsharp, revisa el repositorio de GitHub de PDFsharp.
Instalación de PDFsharp
Para comenzar con PDFSharp, instala el paquete a través de NuGet usando la línea de comandos:
Instalación por línea de comandos:
Install-Package PDFSharp
Alternativamente, puedes buscar "PDFsharp" en el Administrador de Paquetes NuGet e instalarlo desde allí.
Cómo añadir números de página con IronPDF
IronPDF es una biblioteca PDF versátil diseñada para gestionar una amplia gama de operaciones PDF, incluidas la adición de números de página. IronPDF opera internamente en un motor de Chromium, lo que le permite ofrecer una representación precisa del contenido HTML como PDFs. Con su sencilla API, agregar números de página a tu PDF es eficiente y directo.
El siguiente código es un ejemplo de cómo agregar números de página usando IronPDF en C#:
using IronPdf;
class Program
{
static void Main(string[] args)
{
var html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>";
// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer()
{
// Set rendering options for page header
RenderingOptions = {
HtmlHeader = new HtmlHeaderFooter
{
HtmlFragment = "<center><i>{page} of {total-pages}</i></center>" // Page number format
},
}
};
// Render given HTML as PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
// Save the resulting PDF with page numbers
pdf.SaveAs("pageNumbers.pdf");
}
}using IronPdf;
class Program
{
static void Main(string[] args)
{
var html = "<h1>Hello World!</h1><p>This document was generated using IronPDF</p>";
// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer()
{
// Set rendering options for page header
RenderingOptions = {
HtmlHeader = new HtmlHeaderFooter
{
HtmlFragment = "<center><i>{page} of {total-pages}</i></center>" // Page number format
},
}
};
// Render given HTML as PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);
// Save the resulting PDF with page numbers
pdf.SaveAs("pageNumbers.pdf");
}
}Resultado

Este código demuestra cómo insertar fácilmente números de página en el encabezado de un documento PDF. El objeto HtmlHeaderFooter se utiliza para especificar el contenido del encabezado, y marcadores de posición como {page} y {total-pages} se rellenan automáticamente con el número de página y el conteo total de páginas respectivamente.
Con este enfoque, IronPDF simplifica el proceso de renderización de HTML como PDFs mientras gestiona la colocación de números de página sin esfuerzo.
Cómo añadir números de página con PDFsharp
PDFSharp es una biblioteca completa para trabajar con PDFs en C#. Proporciona herramientas para crear, modificar y leer PDFs. Aunque no está diseñada específicamente para la conversión de HTML a PDF, ofrece un control robusto sobre documentos PDF, incluida la capacidad de agregar números de página usando eventos de página personalizados. Ya sea que desees agregar números de página solo a la primera página, o segunda página, un rango de páginas, o simplemente a todas.
Aquí hay un ejemplo de cómo agregar números de página usando PDFSharp:
using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
using PdfSharp.Drawing;
internal class Program
{
static void Main(string[] args)
{
// Create a new PDF document
var doc = new PdfDocument();
doc.Info.Title = "Page Numbers Example";
// Add a new page to the document
PdfPage page = doc.AddPage();
// Create graphics object for drawing
var gfx = XGraphics.FromPdfPage(page);
var font = new XFont("Arial", 12);
// Draw page number in the footer
gfx.DrawString("Page " + doc.PageCount, font, XBrushes.Black, new XPoint(500, 770));
// Save the PDF file
doc.Save("PdfSharpOutput.pdf");
}
}using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
using PdfSharp.Drawing;
internal class Program
{
static void Main(string[] args)
{
// Create a new PDF document
var doc = new PdfDocument();
doc.Info.Title = "Page Numbers Example";
// Add a new page to the document
PdfPage page = doc.AddPage();
// Create graphics object for drawing
var gfx = XGraphics.FromPdfPage(page);
var font = new XFont("Arial", 12);
// Draw page number in the footer
gfx.DrawString("Page " + doc.PageCount, font, XBrushes.Black, new XPoint(500, 770));
// Save the PDF file
doc.Save("PdfSharpOutput.pdf");
}
}Resultado

Conclusión
En resumen, IronPDF se destaca por su capacidad para agregar fácilmente números de página a documentos PDF existentes en un bloque conciso de código, brindándote control total sobre cómo y dónde se muestran tus números de página. Mientras que PDFsharp es una opción versátil para crear y manipular PDFs con un control detallado, lleva a un enfoque más manual y difícil de implementar para agregar números de página a los archivos PDF.
La licencia comercial de IronPDF está disponible, permitiendo a los usuarios evaluar sus características antes de comprometerse con una compra.
Para obtener más información sobre IronPDF, visita la página de documentación, y para PDFsharp, revisa el repositorio de GitHub.
Preguntas Frecuentes
¿Cómo puedo agregar números de página a un PDF usando C#?
Puedes agregar números de página a un PDF en C# usando IronPDF configurando encabezados o pies de página personalizados con la clase HtmlHeaderFooter, incorporando marcadores de posición como {page} y {total-pages} para mostrar números de página.
¿Cuáles son las ventajas de usar IronPDF para la manipulación de PDF?
IronPDF proporciona un conjunto completo de funciones como convertir HTML, CSS y JavaScript a PDF, agregar marcas de agua e integrar encabezados y pies de página personalizados. Utiliza un motor basado en Chromium, asegurando una renderización PDF de alta calidad, lo cual es ideal para desarrolladores web.
¿Cómo difiere PDFsharp de IronPDF en términos de creación de PDF?
PDFsharp ofrece un enfoque más manual para la creación de PDF, permitiendo un control detallado sobre la estructura y el diseño del documento. Se enfoca en agregar elementos como texto, imágenes y tablas directamente, mientras que IronPDF agiliza el proceso con renderización basada en HTML.
¿Cuáles son los pasos de instalación para IronPDF en una aplicación .NET?
Para instalar IronPDF en una aplicación .NET, utiliza el Administrador de Paquetes NuGet en Visual Studio. Puedes ejecutar el comando Install-Package IronPdf en la línea de comandos o buscar 'IronPDF' directamente en la interfaz del Administrador de Paquetes NuGet.
¿Puede usar IronPDF para convertir sitios web a PDF?
Sí, IronPDF puede convertir sitios web completos o contenido HTML específico en documentos PDF. Utiliza un motor basado en Chromium para asegurar la renderización precisa de páginas web, incluyendo CSS y JavaScript.
¿Es IronPDF adecuado para agregar marcas de agua a PDFs?
IronPDF es altamente adecuado para agregar marcas de agua a PDFs. Te permite integrar marcas de agua basadas en texto o en imágenes sin problemas en tus documentos PDF durante el proceso de renderización.
¿Cuáles son los casos de uso típicos para usar PDFsharp?
PDFsharp se usa típicamente para proyectos que requieren un control detallado sobre la creación de documentos PDF, como agregar texto, imágenes y tablas con ajustes precisos de diseño. Es preferido por los desarrolladores que necesitan manipular manualmente la estructura del PDF.
¿Cómo pueden los desarrolladores elegir entre IronPDF y PDFsharp?
Los desarrolladores deben elegir IronPDF si necesitan una solución de renderización sencilla y de alta calidad con menos intervención manual, especialmente al tratar con contenido HTML. PDFsharp es más adecuado para aquellos que requieren una amplia personalización y control manual de los elementos PDF.






