Crear PDF desde Array de Bytes C# iTextSharp (vs IronPDF)

iText 7 es el sucesor oficial de iTextSharp y ofrece una arquitectura completamente rediseñada. Es una biblioteca poderosa y extensible, adecuada para crear, editar y validar PDFs en industrias con alta necesidad de cumplimiento como legal, financiera y gubernamental. La suite iText 7 incluye soporte para PDF/A, PDF/UA, firmas digitales, redacción y creación de formularios.

Aunque sigue siendo de código abierto bajo la licencia AGPL, la licencia comercial está disponible para proyectos propietarios.

Características principales de iText 7

• API moderna, reemplazando la estructura más antigua de iTextSharp
• Soporte modular: HTML a PDF, PDF/A, formularios, redacción, firmas digitales
• Alto rendimiento para aplicaciones empresariales
• Excelente para PDF/A, accesibilidad, cumplimiento

Instalación (NuGet)

Para descargar el paquete principal de iText 7 para la generación de PDF:

Install-Package itext7

También puedes instalar iText 7 a través del Gestor de Paquetes para la pantalla de Solución. Para hacer esto, primero debes ir al menú desplegable de Herramientas, luego encontrar "Gestor de Paquetes NuGet > Administrar Paquetes NuGet para la Solución".

Luego, simplemente busca iText 7 y haz clic en "Instalar".

Ejemplo de código: Crear documentos PDF a partir de matrices de bytes con iText 7

using System.IO;
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfWithIText7();
        // Save the PDF to a file
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfWithIText7()
    {
        using (var ms = new MemoryStream())
        {
            var writer = new PdfWriter(ms);
            var pdf = new iText.Kernel.Pdf.PdfDocument(writer);
            var doc = new Document(pdf);

            doc.Add(new Paragraph("Hello from iText 7 for .NET!"));

            doc.Close(); // Always close the document to finalize content  
            return ms.ToArray();
        }
    }
}

using System.IO;
using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfWithIText7();
        // Save the PDF to a file
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfWithIText7()
    {
        using (var ms = new MemoryStream())
        {
            var writer = new PdfWriter(ms);
            var pdf = new iText.Kernel.Pdf.PdfDocument(writer);
            var doc = new Document(pdf);

            doc.Add(new Paragraph("Hello from iText 7 for .NET!"));

            doc.Close(); // Always close the document to finalize content  
            return ms.ToArray();
        }
    }
}

Archivo PDF de salida

Explicación

• PdfWriter escribe el contenido en un MemoryStream.
• PdfDocument gestiona la estructura interna del PDF.
• Document se utiliza para añadir contenido de alto nivel (texto, imágenes, tablas).
• Después de llamar doc.Close(), el contenido del PDF está completamente escrito y listo para ser retornado como un arreglo de bytes.

Este ejemplo muestra la API más modular y legible de iText 7 en comparación con iTextSharp. Sin embargo, aún carece de soporte nativo para renderizar HTML/CSS a menos que incluyas pdfhtml, que se licencia por separado.

Pros y contras de iText 7

Pros:

• Control Integral de PDF\ iText 7 proporciona control total sobre elementos PDF, como tablas, formularios y firmas digitales. Esto lo hace ideal para aplicaciones con alto cumplimiento que requieren estándares específicos de PDF, como PDF/A o PDF/UA.

• Modular y Escalable\ iText 7 es modular, lo que significa que puedes instalar solo los módulos específicos que necesitas (por ejemplo, pdfhtml para conversión de HTML a PDF). Esto permite una implementación más ligera si no estás utilizando todas las características.

• Soporta Estándares Complejos de PDF\ iText 7 soporta estándares ISO como PDF/A (archivo), PDF/UA (accesibilidad) y PDF/X (impresión), haciéndolo adecuado para entornos profesionales y legales donde el cumplimiento es crucial.

• Documentación Rica y Soporte\ iText 7 tiene documentación integral y una gran comunidad. La empresa también ofrece soporte profesional, asegurando que los desarrolladores puedan obtener asistencia cuando sea necesario.

• Versión Gratuita Disponible (AGPL)\ Los desarrolladores pueden usar iText 7 de forma gratuita bajo la licencia AGPL, lo que es ideal para proyectos de código abierto o uso personal.

Contras:

• Licencia AGPL para Uso Comercial\ Aunque iText 7 ofrece una versión gratuita, los usuarios comerciales deben cumplir con la licencia AGPL, que obliga a liberar el código fuente de cualquier software que utilice iText 7 o pagar por una licencia comercial.

• Curva de Aprendizaje Pronunciada\ La API de iText 7 es más compleja y rica en funciones, lo que puede resultar en una curva de aprendizaje más pronunciada en comparación con bibliotecas más simples como IronPDF. Los desarrolladores necesitan familiarizarse con su estructura de documentos de bajo nivel y arquitectura basada en módulos.

• Pesada para Tareas Simples\ iText 7 puede parecer engorrosa para tareas básicas de PDF, como la creación simple de documentos o conversión básica de HTML a PDF, especialmente cuando se compara con bibliotecas como IronPDF, que simplifican el proceso.

• Requiere Módulos Externos para HTML a PDF\ La conversión de HTML a PDF en iText 7 solo está disponible a través del módulo adicional pdfhtml, que requiere una instalación separada y puede no manejar el contenido web moderno tan fácilmente como IronPDF.

IronPDF es una biblioteca .NET de alto nivel diseñada para simplificar la generación de documentos PDF con un enfoque en la productividad del desarrollador. Es particularmente efectiva para renderizar contenido HTML y estilos, haciéndola ideal para flujos de trabajo modernos de web a PDF.

Características principales:

• Crear archivos PDF desde arreglos de bytes y trabajar con documentos PDF sin necesidad de instalar Adobe Reader
• Renderizado directo de HTML a PDF usando el motor completo de Chromium para crear documentos PDF a partir de contenido HTML
• Funciona con Vistas MVC, Razor Pages y URLs locales/remotas
• Soporta archivos de imagen, JavaScript, CSS y diseños responsivos de serie
• Sintaxis fácil de usar y configuración mínima requerida
• Licencias perpetuas y sin restricciones AGPL

IronPDF también se puede instalar a través de NuGet, ejecutando el siguiente comando en la consola del gestor de paquetes NuGet:

Install-Package IronPdf

Alternativamente, puedes instalarlo a través del gestor de paquetes NuGet para la pantalla de Solución. Para hacer esto, navega a "Herramientas > Gestor de Paquetes NuGet > Administrar Paquetes NuGet para la Solución".

Luego, busca IronPDF y haz clic en "Instalar".

Después de la instalación, puedes empezar a renderizar páginas HTML completas a PDF en segundos, sin necesidad de módulos adicionales. Soporta CSS moderno, JavaScript e incluso contenido web interactivo sin configuración adicional.

Ejemplo de código: Crear documentos PDF a partir de una matriz de bytes con IronPDF

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfWithIronPdf();
        // Save the PDF to a file
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfWithIronPdf()
    {
        var renderer = new ChromePdfRenderer();
        var pdfDoc = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
        return pdfDoc.BinaryData;
    }
}

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfWithIronPdf();
        // Save the PDF to a file
        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfWithIronPdf()
    {
        var renderer = new ChromePdfRenderer();
        var pdfDoc = renderer.RenderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
        return pdfDoc.BinaryData;
    }
}

Archivo PDF de salida

Explicación

• La declaración using IronPdf importa la biblioteca IronPDF para acceder a todas las clases relacionadas con PDF.
• var renderer = new ChromePdfRenderer() crea un nuevo renderizador de HTML a PDF potenciado por un motor de Chromium sin cabeza.
• renderer.RenderHtmlAsPdf(...) convierte la cadena HTML dada en un documento PDF. También puedes pasar rutas de archivos o URLs.
• pdfDoc.BinaryData devuelve el PDF final como un arreglo de bytes, listo para guardar, transmitir o almacenar en base de datos.

Pros y contras de IronPDF

Pros:

• Renderizado HTML a PDF sin Esfuerzo\ Renderiza contenido HTML, CSS y JavaScript directamente en PDFs con estilo completo, incluyendo Bootstrap y fuentes personalizadas, sin necesitar código de diseño complejo o módulos adicionales.

• Inicio Rápido y API Intuitiva\ Crea archivos PDF completamente estilizados en solo unas pocas líneas de código, con sintaxis limpia y compatibilidad completa con .NET Core y .NET Framework.

• Soporte Integral para Tecnologías Web\ IronPDF soporta JavaScript, CSS moderno, SVGs y queries de medios, algo con lo que la mayoría de las bibliotecas lidian a menos que usen navegadores sin cabeza como Chromium (lo que IronPDF hace internamente).

• Gestión Incorporada de Imágenes y Recursos\ Incluye fácilmente imágenes, archivos locales e incluso recupera recursos de URLs remotas sin configuración adicional.

• Licencias Perpetuas y Sin AGPL\ A diferencia de iText 7, IronPDF ofrece licencias comerciales flexibles sin las restricciones de las obligaciones de código abierto AGPL.

• Excelente para Vistas MVC y Razor\ Convierte fácilmente Vistas Razor .cshtml en aplicaciones ASP.NET en PDFs imprimibles.

Contras:

• El Uso Comercial Requiere Licencia\ Aunque hay una prueba gratuita, IronPDF no es de código abierto. Los proyectos con presupuestos ajustados pueden necesitar evaluar los costos de licencia.

• Tamaño de Paquete Inicial Más Grande\ Dado que incluye un motor Chromium sin cabeza, el paquete NuGet es más pesado que algunas alternativas.

HierroPDF

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfFromUrlWithIronPdf();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-from-url.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfFromUrlWithIronPdf()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.WaitForJavaScript(5000);
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

        var pdf = renderer.RenderUrlAsPdf("https://www.apple.com");
        return pdf.BinaryData;
    }
}

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.GeneratePdfFromUrlWithIronPdf();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-from-url.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] GeneratePdfFromUrlWithIronPdf()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.WaitForJavaScript(5000);
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

        var pdf = renderer.RenderUrlAsPdf("https://www.apple.com");
        return pdf.BinaryData;
    }
}

PDF de Salida

IronPDF utiliza un motor Chromium sin cabeza para un renderizado preciso al píxel de páginas web con soporte completo de JavaScript y CSS.

iTexto 7

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using System.Net.Http;
using System.Threading.Tasks;
using iText.Html2pdf;
using System.IO;

class Program
{
    static async Task Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = await pdfGenerator.GeneratePdfFromUrlWithIText7Async();

        // Save the PDF to a file
        File.WriteAllBytes("itext7-from-url.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public async Task<byte[]> GeneratePdfFromUrlWithIText7Async()
    {
        using var httpClient = new HttpClient();
        string html = await httpClient.GetStringAsync("https://www.apple.com");

        using var stream = new MemoryStream();
        HtmlConverter.ConvertToPdf(html, stream);
        return stream.ToArray();
    }
}

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using System.Net.Http;
using System.Threading.Tasks;
using iText.Html2pdf;
using System.IO;

class Program
{
    static async Task Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = await pdfGenerator.GeneratePdfFromUrlWithIText7Async();

        // Save the PDF to a file
        File.WriteAllBytes("itext7-from-url.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public async Task<byte[]> GeneratePdfFromUrlWithIText7Async()
    {
        using var httpClient = new HttpClient();
        string html = await httpClient.GetStringAsync("https://www.apple.com");

        using var stream = new MemoryStream();
        HtmlConverter.ConvertToPdf(html, stream);
        return stream.ToArray();
    }
}

Salida

iText 7 obtiene HTML en bruto con HttpClient y lo renderiza usando HtmlConverter, pero no soporta ejecución de JavaScript (según lo confirma la documentación oficial de iText, que recomienda usar Selenium o similar para procesamiento previo de JavaScript) y tiene soporte CSS limitado. Mientras iText7 añadió soporte parcial para flexbox en la versión 7.1.15 (2021), muchas propiedades de CSS3 siguen sin soportarse, particularmente para diseños modernos complejos.

HierroPDF

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreatePdfWithImage();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-with-image.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreatePdfWithImage()
    {
        var pdf = ImageToPdfConverter.ImageToPdf("example.png");
        return pdf.BinaryData;
    }
}

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreatePdfWithImage();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-with-image.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreatePdfWithImage()
    {
        var pdf = ImageToPdfConverter.ImageToPdf("example.png");
        return pdf.BinaryData;
    }
}

Salida

Generación fácil de imagen a PDF con el herramienta ImageToPdfConverter de IronPDF. Con esto, puedes fácilmente crear archivos PDF a partir de imágenes como archivos PNG o JPGs.

iTexto 7

using iText.Kernel.Pdf;
using iText.Layout;
using iText.IO.Image;
using iText.Layout.Element;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreatePdfWithImage();

        // Save the PDF to a file
        File.WriteAllBytes("iText-with-image.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreatePdfWithImage()
    {
        using var ms = new MemoryStream();
        using var writer = new PdfWriter(ms);
        using var pdfDoc = new iText.Kernel.Pdf.PdfDocument(writer);
        var document = new Document(pdfDoc);

        var img = new Image(ImageDataFactory.Create("https://itextpdf.com/sites/default/files/2018-11/iText%207%20Product%20software%20-%20webimages_509x339px_V2_iText%207%20Core.png"));
        document.Add(img);
        document.Close();

        return ms.ToArray();
    }
}

using iText.Kernel.Pdf;
using iText.Layout;
using iText.IO.Image;
using iText.Layout.Element;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreatePdfWithImage();

        // Save the PDF to a file
        File.WriteAllBytes("iText-with-image.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreatePdfWithImage()
    {
        using var ms = new MemoryStream();
        using var writer = new PdfWriter(ms);
        using var pdfDoc = new iText.Kernel.Pdf.PdfDocument(writer);
        var document = new Document(pdfDoc);

        var img = new Image(ImageDataFactory.Create("https://itextpdf.com/sites/default/files/2018-11/iText%207%20Product%20software%20-%20webimages_509x339px_V2_iText%207%20Core.png"));
        document.Add(img);
        document.Close();

        return ms.ToArray();
    }
}

Salida

Creación manual de diseño de documento e inserción explícita de imagen usando ImageDataFactory.

HierroPDF

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreateStyledPdf();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-styled-html.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreateStyledPdf()
    {
        string html = @"
        <html>
            <head>
                <style>
                    body { 
                        background-color: #f0f0f0; 
                        margin: 20px; 
                        padding: 20px; 
                        border-radius: 5px; 
                        box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
                    }
                    h1 { 
                        color: navy;
                        font-size: 32px;   
                        text-align: center;
                       }
                    p { 
                        font-size: 16px; 
                        font-weight: bold;
                      }
                </style>
            </head>
            <body>
                <h1>Welcome to IronPDF</h1>
                <p>This is a simple PDF document generated using IronPDF.</p>
            </body>
        </html>";

        var pdf = new ChromePdfRenderer().RenderHtmlAsPdf(html);
        return pdf.BinaryData;
    }
}

using IronPdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreateStyledPdf();

        // Save the PDF to a file
        File.WriteAllBytes("ironpdf-styled-html.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreateStyledPdf()
    {
        string html = @"
        <html>
            <head>
                <style>
                    body { 
                        background-color: #f0f0f0; 
                        margin: 20px; 
                        padding: 20px; 
                        border-radius: 5px; 
                        box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
                    }
                    h1 { 
                        color: navy;
                        font-size: 32px;   
                        text-align: center;
                       }
                    p { 
                        font-size: 16px; 
                        font-weight: bold;
                      }
                </style>
            </head>
            <body>
                <h1>Welcome to IronPDF</h1>
                <p>This is a simple PDF document generated using IronPDF.</p>
            </body>
        </html>";

        var pdf = new ChromePdfRenderer().RenderHtmlAsPdf(html);
        return pdf.BinaryData;
    }
}

Salida

IronPDF soporta completamente CSS en etiquetas u hojas de estilo externas gracias a su motor Chromium.

iTexto 7 + pdfHTML

using iText.Kernel.Pdf;
using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreateStyledPdf();

        // Save the new document to the specified file location
        File.WriteAllBytes("iText-styled-html.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreateStyledPdf()
    {
        string html = @"
        <html>
            <head>
                <style>
                    body { 
                        background-color: #f0f0f0; 
                        margin: 20px; 
                        padding: 20px; 
                        border-radius: 5px; 
                        box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
                    }
                    h1 { 
                        color: navy;
                        font-size: 32px;   
                        text-align: center;
                       }
                    p { 
                        font-size: 16px; 
                        font-weight: bold;
                      }
                </style>
            </head>
            <body>
                <h1>Welcome to iText 7</h1>
                <p>This is a simple PDF document generated using iText 7 and pdfHTML.</p>
            </body>
        </html>";

        using var ms = new MemoryStream();
        ConverterProperties properties = new ConverterProperties();
        HtmlConverter.ConvertToPdf(new MemoryStream(System.Text.Encoding.UTF8.GetBytes(html)), ms, properties);
        return ms.ToArray();
    }
}

using iText.Kernel.Pdf;
using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main(string[] args)
    {
        var pdfGenerator = new PdfGenerator();
        byte[] pdfBytes = pdfGenerator.CreateStyledPdf();

        // Save the new document to the specified file location
        File.WriteAllBytes("iText-styled-html.pdf", pdfBytes);
    }
}

class PdfGenerator
{
    public byte[] CreateStyledPdf()
    {
        string html = @"
        <html>
            <head>
                <style>
                    body { 
                        background-color: #f0f0f0; 
                        margin: 20px; 
                        padding: 20px; 
                        border-radius: 5px; 
                        box-shadow: 0 0 10px rgba(0, 0, 0, 0.1);
                    }
                    h1 { 
                        color: navy;
                        font-size: 32px;   
                        text-align: center;
                       }
                    p { 
                        font-size: 16px; 
                        font-weight: bold;
                      }
                </style>
            </head>
            <body>
                <h1>Welcome to iText 7</h1>
                <p>This is a simple PDF document generated using iText 7 and pdfHTML.</p>
            </body>
        </html>";

        using var ms = new MemoryStream();
        ConverterProperties properties = new ConverterProperties();
        HtmlConverter.ConvertToPdf(new MemoryStream(System.Text.Encoding.UTF8.GetBytes(html)), ms, properties);
        return ms.ToArray();
    }
}

Salida

Requiere la instalación del complemento de pago pdfHTML para manejar tareas de conversión de HTML.