Cómo generar un PDF en C# (.NET 5) usando PDFSharp

Instalación y configuración

Antes de entrar en el código, el orador destaca que configurar el entorno para PDFsharp puede ser bastante desafiante. Explican que deben instalarse tres paquetes NuGet antes de trabajar con Detalles del Paquete NuGet de PDFsharp. El primer paquete es PDFsharp en sí, que puede generar una advertencia de que puede no coincidir con .NET debido a su versión anterior. Los otros dos paquetes son System.Drawing.Common y System.Text.Encoding.CodePages.

El orador enfatiza que deben instalarse los tres paquetes antes de trabajar con PDFsharp; de lo contrario, el código mostrará un error. Explican que el paquete System.Text.Encoding.CodePages es especialmente importante ya que proporciona el soporte de codificación necesario para generar archivos PDF. El orador también señala que el no instalar correctamente los paquetes podría ser difícil de solucionar. Los equipos que deseen evitar esta configuración de múltiples paquetes por completo pueden seguir la guía de migración de PDFsharp a IronPDF para una transición paso a paso.

Creación de un archivo PDF

A continuación, el ponente presenta una simple aplicación de consola que utiliza PDFsharp para generar un archivo PDF. Explican que antes de usar la biblioteca, se deben declarar las sentencias using para PDFsharp Drawing y PDFsharp PDF. El orador entonces presenta el código para generar el archivo PDF, que implica crear un nuevo documento, agregar una nueva página, y dibujar el texto en la página.

using PdfSharp.Drawing;
using PdfSharp.Pdf;

namespace PdfSharpExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a new PDF document
            PdfDocument document = new PdfDocument();
            // Add a new page
            PdfPage page = document.AddPage();
            // Prepare to draw on the page
            XGraphics gfx = XGraphics.FromPdfPage(page);
            // Define a font
            XFont font = new XFont("Verdana", 20, XFontStyle.Bold);

            // Draw a string to the page
            gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black,
                new XRect(0, 0, page.Width, page.Height),
                XStringFormats.Center);

            // Save the document
            const string filename = "HelloWorld.pdf";
            document.Save(filename);  
        }
    }
}

using PdfSharp.Drawing;
using PdfSharp.Pdf;

namespace PdfSharpExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a new PDF document
            PdfDocument document = new PdfDocument();
            // Add a new page
            PdfPage page = document.AddPage();
            // Prepare to draw on the page
            XGraphics gfx = XGraphics.FromPdfPage(page);
            // Define a font
            XFont font = new XFont("Verdana", 20, XFontStyle.Bold);

            // Draw a string to the page
            gfx.DrawString("Hello, PDFsharp!", font, XBrushes.Black,
                new XRect(0, 0, page.Width, page.Height),
                XStringFormats.Center);

            // Save the document
            const string filename = "HelloWorld.pdf";
            document.Save(filename);  
        }
    }
}

El ponente señala que el código para generar el archivo PDF se puede ajustar para incluir características más complejas, como agregar imágenes (ver cómo convertir imágenes a PDF con IronPDF), tablas y gráficos. También explican que PDFsharp proporciona diversas características para trabajar con fuentes, incluyendo incrustar fuentes en el archivo PDF.

El ponente explica la importancia de configurar correctamente el entorno instalando los paquetes NuGet necesarios y registrando un proveedor para System.Text.Encoding. También presentan una simple aplicación de consola que utiliza PDFsharp para generar un archivo PDF y demuestran cómo se puede ajustar el código para incluir características más complejas. El video es un excelente recurso para cualquiera interesado en generar archivos PDF usando C# y PDFsharp.

Creación de listas y elementos más complejos

En la segunda parte del video, el orador comienza introduciendo un ejemplo más complejo de creación de un documento PDF. Él enfatiza que es inútil tener un documento PDF vacío y procede a explicar cómo crear una nueva página usando la biblioteca PDFSharp. Señala que el proceso es similar a crear cosas en complementos de Excel o PowerPoint, y que una vez que se crea la página, funciona con una referencia que no requiere la invocación de otro método.

El ponente luego introduce la variable XGraphics, que proporciona métodos para dibujar cosas como texto, líneas e imágenes — funcionalidad queIronPDFmaneja a través de su API de estampado de texto e imágenes sin requerir cálculos de coordenadas manuales. La variable XFont también se introduce como un medio para configurar una fuente para su uso en el documento PDF. El orador señala que la fuente se puede generar en otra parte, pero que es útil configurarla globalmente si hay un arreglo más complejo.

A continuación, el ponente discute el método DrawString, que escribe texto en el archivo PDF. Señala que la parte compleja del método es determinar dónde se dibujará el texto y explica los distintos parámetros involucrados, como la fuente, el color y los límites de donde podría alinearse el texto. También explica el uso de la variable XBrushes para establecer el color del texto.

¿Qué biblioteca elegir?

En conclusión, el orador enfatiza la importancia de estar familiarizado con los complementos de Microsoft Office al trabajar conPDFSharpy ofrece su propio curso sobre el tema. También señala que la biblioteca es altamente versátil y puede usarse para crear una amplia gama de documentos PDF, desde documentos de texto simples hasta más complejos con imágenes, gráficos y diseños personalizados.

¿Qué es IronPDF?

IronPDF es una biblioteca de PDF para C# para crear, editar y manipular documentos PDF. Se envía como un solo paquete NuGet — Install-Package IronPdf — e integra con aplicaciones .NET sin requerir configuración adicional de dependencias.

PDFsharp proporciona un sólido control de dibujo a nivel bajo y se distribuye bajo una licencia permisiva MIT — dos verdaderas fortalezas que lo han convertido en un elemento básico en muchos proyectos .NET. Donde los equipos a menudo encuentran fricción es cuando los requisitos crecen más allá del renderizado basado en coordenadas a áreas como conversión de HTML a PDF, firmas digitales o cifrado de documentos.IronPDFes una biblioteca comercialmente soportada que aborda esos escenarios como operaciones de primera clase, con soporte profesional y una superficie de API diseñada en torno a flujos de trabajo comunes de generación de documentos, incluida la renderización de HTML, CSS y JavaScript.

Características

Una de las características clave deIronPDFes su capacidad para convertir HTML a PDF usando IronPDF, lo que hace que sea sencillo crear documentos PDF a partir de páginas web. La conversión de HTML a PDF está fuera del alcance actual de PDFsharp — opera a nivel de dibujo basado en coordenadas — por lo que los equipos que necesiten esa capacidad suelen agregar una biblioteca de renderizado separada o evaluar el motor Chromium integrado de IronPDF.

IronPDF también incluye soporte para firmas digitales y cifrado de PDF con protección de contraseña, que es crucial para documentos sensibles que requieren un manejo seguro. PDFsharp no está diseñado para abordar estos escenarios de seguridad, por lo que los equipos con requisitos de cumplimiento o protección de documentos a menudo encuentran este un punto de inflexión natural para evaluar IronPDF.

IronPDF proporciona un conjunto de características más amplio y una oferta de soporte más completa en comparación con PDFsharp, cubriendo renderización HTML, cifrado y firmas digitales en un solo paquete NuGet. Es un producto comercial, sin embargo, por lo que los equipos cuyos requisitos encajan dentro del modelo de dibujo por coordenadas de PDFsharp — y que no necesitan conversión de HTML ni características de seguridad integradas — pueden preferir el enfoque de código abierto bajo licencia MIT de PDFsharp.

Más allá del costo de la licencia, el costo total del proyecto incluye las horas de desarrollador gastadas ensamblando bibliotecas de renderizado separadas, gestionando diseños de página basados en coordenadas para documentos complejos y solucionando problemas con la configuración de múltiples paquetes que requiere PDFsharp. Para equipos que evalúan el costo en un ciclo de vida de proyecto de varios años, estos costos de integración y mantenimiento a menudo superan la diferencia entre las licencias de código abierto y comerciales.

¿Listo para ver cómo se adaptaIronPDFa tu flujo de trabajo? Descarga una prueba gratuita de 30 días para probar cada característica cubierta en esta comparación.