Crear PDF en ASP.NET: iTextSharp vs IronPDF

¿Cuáles son las principales diferencias entre iTextSharp y IronPDF?

iTextSharp es una adaptación a .NET de la biblioteca iText de Java, que ofrece creación programática de PDF a través de su clase documental y manipulación de bajo nivel del contenido PDF. Aunque potente, el uso de iTextSharp requiere comprender la estructura del documento PDF, trabajar con objetos de documento y posicionar manualmente los elementos utilizando coordenadas y especificaciones de tamaño de página. La API es detallada por necesidad: la biblioteca expone toda la complejidad de la especificación PDF, lo que significa que hay mucho que aprender antes de producir un resultado pulido.

IronPDF adopta un enfoque diferente, centrándose en la conversión de HTML a PDF mediante un motor de renderizado de Chrome. Los desarrolladores pueden generar archivos PDF con HTML y CSS habituales, lo que hace que la creación de PDF sea tan sencilla como diseñar una página web. IronPDF maneja la lógica de generación de PDF detrás de escena, lo que le permite producir documentos con un estilo moderno y soporte JavaScript . Debido a que el proceso de renderizado está impulsado por Chromium, cualquier diseño que funcione en un navegador moderno se traducirá fielmente a la salida PDF, incluidos flexbox, cuadrícula, fuentes web y contenido generado por JavaScript.

La consecuencia práctica de esta diferencia arquitectónica es que iTextSharp recompensa a los desarrolladores que desean un control detallado a nivel de coordenadas sobre cada byte de un archivo PDF, mientras que IronPDF recompensa a los desarrolladores que desean producir documentos visualmente pulidos rápidamente utilizando las habilidades que ya tienen. Para la mayoría de los escenarios de aplicaciones web (facturas, informes, confirmaciones de pedidos y exportaciones de datos), el enfoque HTML es más rápido de crear y más fácil de mantener.

¿Cómo instalar estas bibliotecas en un proyecto .NET ?

La instalación de cualquiera de las bibliotecas comienza con el Administrador de paquetes NuGet . Para iTextSharp, tenga en cuenta que las versiones más nuevas de iText funcionan bajo la licencia AGPL , que requiere que su aplicación sea de código abierto o que compre una licencia comercial:

# Install iTextSharp via Package Manager Console
Install-Package iTextSharp

# Install iTextSharp via Package Manager Console
Install-Package iTextSharp

Para IronPDF, puede instalarlo a través de la consola del administrador de paquetes NuGet , la CLI de .NET o buscando directamente en la interfaz de usuario NuGet de Visual Studio:

Install-Package IronPdf

Después de la instalación, IronPDF está listo para usarse con una única instrucción using. No se requiere configuración adicional para la generación básica de PDF. Para escenarios avanzados, como configurar una clave de licencia , configurar opciones de renderizado o generar archivos PDF en un entorno de nube, consulte la documentación de IronPDF . IronPDF es compatible con implementaciones de Linux, macOS y Windows, incluidos entornos en contenedores que se ejecutan en Docker o Kubernetes, lo que lo hace ideal para aplicaciones ASP.NET nativas de la nube modernas.

¿Cómo crear un documento PDF básico con cada biblioteca?

La forma más clara de entender la diferencia de API es crear un PDF simple de "Hola mundo" con ambas bibliotecas una al lado de la otra.

using iTextSharp.text;
using iTextSharp.text.pdf;

var memoryStream = new MemoryStream();
Document pdfDoc = new Document(PageSize.A4, 25, 25, 25, 15);
PdfWriter writer = PdfWriter.GetInstance(pdfDoc, memoryStream);
pdfDoc.Open();

var paragraph = new Paragraph("Hello World - PDF Document");
paragraph.Font = FontFactory.GetFont(FontFactory.HELVETICA, 16);
pdfDoc.Add(paragraph);
pdfDoc.Add(new Paragraph("Creating PDF documents with iTextSharp"));

pdfDoc.Close();

// Return as a downloadable file
var pdfBytes = memoryStream.ToArray();

using iTextSharp.text;
using iTextSharp.text.pdf;

var memoryStream = new MemoryStream();
Document pdfDoc = new Document(PageSize.A4, 25, 25, 25, 15);
PdfWriter writer = PdfWriter.GetInstance(pdfDoc, memoryStream);
pdfDoc.Open();

var paragraph = new Paragraph("Hello World - PDF Document");
paragraph.Font = FontFactory.GetFont(FontFactory.HELVETICA, 16);
pdfDoc.Add(paragraph);
pdfDoc.Add(new Paragraph("Creating PDF documents with iTextSharp"));

pdfDoc.Close();

// Return as a downloadable file
var pdfBytes = memoryStream.ToArray();

Imports iTextSharp.text
Imports iTextSharp.text.pdf

Dim memoryStream As New MemoryStream()
Dim pdfDoc As New Document(PageSize.A4, 25, 25, 25, 15)
Dim writer As PdfWriter = PdfWriter.GetInstance(pdfDoc, memoryStream)
pdfDoc.Open()

Dim paragraph As New Paragraph("Hello World - PDF Document")
paragraph.Font = FontFactory.GetFont(FontFactory.HELVETICA, 16)
pdfDoc.Add(paragraph)
pdfDoc.Add(New Paragraph("Creating PDF documents with iTextSharp"))

pdfDoc.Close()

' Return as a downloadable file
Dim pdfBytes As Byte() = memoryStream.ToArray()

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(@"
    <h1>Hello World - PDF Document</h1>
    <p>Creating PDFs with IronPDF is straightforward!</p>
");

var pdfBytes = pdf.BinaryData;

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(@"
    <h1>Hello World - PDF Document</h1>
    <p>Creating PDFs with IronPDF is straightforward!</p>
");

var pdfBytes = pdf.BinaryData;

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("
    <h1>Hello World - PDF Document</h1>
    <p>Creating PDFs with IronPDF is straightforward!</p>
")

Dim pdfBytes = pdf.BinaryData

¿Cómo crear archivos PDF con estilo con imágenes y CSS?

Los documentos estilizados revelan la brecha más significativa entre las dos bibliotecas. Al generar facturas, informes o documentos de marca, el estilo basado en CSS en IronPDF reduce drásticamente la cantidad de código necesario.

using IronPdf;

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 0; }
        .invoice-header { background: #4CAF50; color: white; padding: 20px; }
        .invoice-table { width: 100%; border-collapse: collapse; margin-top: 20px; }
        .invoice-table th, .invoice-table td {
            border: 1px solid #ddd; padding: 8px; text-align: left;
        }
        .invoice-table th { background-color: #f2f2f2; }
        .total { font-size: 18px; font-weight: bold; margin-top: 16px; }
    </style>
    <div class='invoice-header'>
        <h1>Invoice #2024-001</h1>
        <p>Due: March 15, 2024</p>
    </div>
    <table class='invoice-table'>
        <tr><th>Item</th><th>Quantity</th><th>Unit Price</th><th>Total</th></tr>
        <tr><td>PDF License</td><td>1</td><td>$599</td><td>$599</td></tr>
        <tr><td>Support Package</td><td>1</td><td>$199</td><td>$199</td></tr>
    </table>
    <p class='total'>Grand Total: $798</p>
";

var renderer = new ChromePdfRenderer();
var pdfDocument = renderer.RenderHtmlAsPdf(html);
var pdfBytes = pdfDocument.BinaryData;

using IronPdf;

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 0; }
        .invoice-header { background: #4CAF50; color: white; padding: 20px; }
        .invoice-table { width: 100%; border-collapse: collapse; margin-top: 20px; }
        .invoice-table th, .invoice-table td {
            border: 1px solid #ddd; padding: 8px; text-align: left;
        }
        .invoice-table th { background-color: #f2f2f2; }
        .total { font-size: 18px; font-weight: bold; margin-top: 16px; }
    </style>
    <div class='invoice-header'>
        <h1>Invoice #2024-001</h1>
        <p>Due: March 15, 2024</p>
    </div>
    <table class='invoice-table'>
        <tr><th>Item</th><th>Quantity</th><th>Unit Price</th><th>Total</th></tr>
        <tr><td>PDF License</td><td>1</td><td>$599</td><td>$599</td></tr>
        <tr><td>Support Package</td><td>1</td><td>$199</td><td>$199</td></tr>
    </table>
    <p class='total'>Grand Total: $798</p>
";

var renderer = new ChromePdfRenderer();
var pdfDocument = renderer.RenderHtmlAsPdf(html);
var pdfBytes = pdfDocument.BinaryData;

Imports IronPdf

Dim html As String = "
    <style>
        body { font-family: Arial, sans-serif; margin: 0; }
        .invoice-header { background: #4CAF50; color: white; padding: 20px; }
        .invoice-table { width: 100%; border-collapse: collapse; margin-top: 20px; }
        .invoice-table th, .invoice-table td {
            border: 1px solid #ddd; padding: 8px; text-align: left;
        }
        .invoice-table th { background-color: #f2f2f2; }
        .total { font-size: 18px; font-weight: bold; margin-top: 16px; }
    </style>
    <div class='invoice-header'>
        <h1>Invoice #2024-001</h1>
        <p>Due: March 15, 2024</p>
    </div>
    <table class='invoice-table'>
        <tr><th>Item</th><th>Quantity</th><th>Unit Price</th><th>Total</th></tr>
        <tr><td>PDF License</td><td>1</td><td>$599</td><td>$599</td></tr>
        <tr><td>Support Package</td><td>1</td><td>$199</td><td>$199</td></tr>
    </table>
    <p class='total'>Grand Total: $798</p>
"

Dim renderer As New ChromePdfRenderer()
Dim pdfDocument = renderer.RenderHtmlAsPdf(html)
Dim pdfBytes = pdfDocument.BinaryData

using iTextSharp.text;
using iTextSharp.text.pdf;

var output = new MemoryStream();
var document = new Document(PageSize.A4);
PdfWriter.GetInstance(document, output);
document.Open();

// Header -- manual font and color setup
var titleFont = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 20,
    new BaseColor(255, 255, 255));
var headerParagraph = new Paragraph("Invoice #2024-001", titleFont);
document.Add(headerParagraph);

// Table -- each cell must be created individually
PdfPTable table = new PdfPTable(4);
table.WidthPercentage = 100;

string[] headers = { "Item", "Quantity", "Unit Price", "Total" };
foreach (var h in headers)
{
    var cell = new PdfPCell(new Phrase(h,
        FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 10)));
    cell.BackgroundColor = new BaseColor(242, 242, 242);
    table.AddCell(cell);
}

table.AddCell("PDF License");
table.AddCell("1");
table.AddCell("$599");
table.AddCell("$599");
document.Add(table);

var totalFont = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 14);
document.Add(new Paragraph("Grand Total: $798", totalFont));
document.Close();

using iTextSharp.text;
using iTextSharp.text.pdf;

var output = new MemoryStream();
var document = new Document(PageSize.A4);
PdfWriter.GetInstance(document, output);
document.Open();

// Header -- manual font and color setup
var titleFont = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 20,
    new BaseColor(255, 255, 255));
var headerParagraph = new Paragraph("Invoice #2024-001", titleFont);
document.Add(headerParagraph);

// Table -- each cell must be created individually
PdfPTable table = new PdfPTable(4);
table.WidthPercentage = 100;

string[] headers = { "Item", "Quantity", "Unit Price", "Total" };
foreach (var h in headers)
{
    var cell = new PdfPCell(new Phrase(h,
        FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 10)));
    cell.BackgroundColor = new BaseColor(242, 242, 242);
    table.AddCell(cell);
}

table.AddCell("PDF License");
table.AddCell("1");
table.AddCell("$599");
table.AddCell("$599");
document.Add(table);

var totalFont = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 14);
document.Add(new Paragraph("Grand Total: $798", totalFont));
document.Close();

Imports iTextSharp.text
Imports iTextSharp.text.pdf

Dim output As New MemoryStream()
Dim document As New Document(PageSize.A4)
PdfWriter.GetInstance(document, output)
document.Open()

' Header -- manual font and color setup
Dim titleFont As Font = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 20, New BaseColor(255, 255, 255))
Dim headerParagraph As New Paragraph("Invoice #2024-001", titleFont)
document.Add(headerParagraph)

' Table -- each cell must be created individually
Dim table As New PdfPTable(4)
table.WidthPercentage = 100

Dim headers As String() = {"Item", "Quantity", "Unit Price", "Total"}
For Each h As String In headers
    Dim cell As New PdfPCell(New Phrase(h, FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 10)))
    cell.BackgroundColor = New BaseColor(242, 242, 242)
    table.AddCell(cell)
Next

table.AddCell("PDF License")
table.AddCell("1")
table.AddCell("$599")
table.AddCell("$599")
document.Add(table)

Dim totalFont As Font = FontFactory.GetFont(FontFactory.HELVETICA_BOLD, 14)
document.Add(New Paragraph("Grand Total: $798", totalFont))
document.Close()

¿Cómo se gestiona la generación de PDF del lado del servidor en ASP.NET?

Ambas bibliotecas admiten la generación de PDF del lado del servidor para aplicaciones ASP.NET . El patrón para devolver un PDF como respuesta de archivo descargable es similar independientemente de qué biblioteca genere los bytes. Las consideraciones clave para el uso en producción son la gestión de la memoria, la seguridad de los subprocesos y la configuración de la respuesta. Ambas bibliotecas utilizan secuencias en memoria, por lo que debes asegurarte de no mantener archivos PDF grandes en la memoria durante más tiempo del necesario. El ChromePdfRenderer de IronPDF está diseñado para ser instanciado por solicitud, por lo que no hay estado compartido del cual preocuparse entre solicitudes concurrentes.

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class PdfController : ControllerBase
{
    [HttpGet("invoice/{id}")]
    public IActionResult GenerateInvoice(int id)
    {
        var html = BuildInvoiceHtml(id); // your HTML template

        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;

        var pdf = renderer.RenderHtmlAsPdf(html);

        return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
    }

    private static string BuildInvoiceHtml(int id)
    {
        return $"<h1>Invoice #{id}</h1><p>Generated on {DateTime.UtcNow:yyyy-MM-dd}</p>";
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class PdfController : ControllerBase
{
    [HttpGet("invoice/{id}")]
    public IActionResult GenerateInvoice(int id)
    {
        var html = BuildInvoiceHtml(id); // your HTML template

        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 20;
        renderer.RenderingOptions.MarginBottom = 20;

        var pdf = renderer.RenderHtmlAsPdf(html);

        return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf");
    }

    private static string BuildInvoiceHtml(int id)
    {
        return $"<h1>Invoice #{id}</h1><p>Generated on {DateTime.UtcNow:yyyy-MM-dd}</p>";
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

<ApiController>
<Route("api/[controller]")>
Public Class PdfController
    Inherits ControllerBase

    <HttpGet("invoice/{id}")>
    Public Function GenerateInvoice(id As Integer) As IActionResult
        Dim html As String = BuildInvoiceHtml(id) ' your HTML template

        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
        renderer.RenderingOptions.MarginTop = 20
        renderer.RenderingOptions.MarginBottom = 20

        Dim pdf = renderer.RenderHtmlAsPdf(html)

        Return File(pdf.BinaryData, "application/pdf", $"invoice-{id}.pdf")
    End Function

    Private Shared Function BuildInvoiceHtml(id As Integer) As String
        Return $"<h1>Invoice #{id}</h1><p>Generated on {DateTime.UtcNow:yyyy-MM-dd}</p>"
    End Function
End Class

¿Cómo migrar de iTextSharp a IronPDF?

La migración de un proyecto iTextSharp existente a IronPDF sigue un patrón sencillo:

1. Reemplaza el código del modelo de documento con plantillas HTML. En lugar de construir objetos Paragraph, PdfPTable y PdfPCell, construye una cadena HTML o carga un archivo HTML. Tus hojas de estilo CSS existentes y vistas parciales de Razor se pueden reutilizar directamente.
2. Intercambiar la llamada de renderización. Reemplaza PdfWriter.GetInstance(doc, stream) con new ChromePdfRenderer().RenderHtmlAsPdf(html).
3. Actualiza la extracción de bytes. Reemplaza memoryStream.ToArray() con pdf.BinaryData.
4. Transfiere configuraciones avanzadas. Las funciones de iTextSharp como márgenes de página, cifrado y metadatos del documento tienen equivalentes directos en las API RenderingOptions y PdfDocument de IronPDF.
5. Valide la fidelidad de la salida. Ejecute ambas salidas simultáneamente en documentos representativos. IronPDF generalmente produce mejores resultados visuales porque utiliza un motor de renderizado de navegador completo en lugar de un motor de diseño nativo de PDF.

Para los equipos con plantillas HTML existentes (de generadores de correo electrónico, vistas de Razor o generadores de informes), la migración a menudo se puede completar en horas en lugar de días. IronPDF puede representar vistas de Razor directamente en PDF dentro de ASP.NET Core, lo que acelera aún más la migración. Los equipos que han invertido en el diseño de documentos basado en CSS (por ejemplo, utilizando hojas de estilo de impresión para controlar los saltos de página y los márgenes) descubrirán que esas habilidades se transfieren directamente a IronPDF.

Revise la guía de migración de IronPDF para obtener patrones detallados que cubren el cifrado, el estampado y otras funciones avanzadas de iTextSharp.

¿Qué biblioteca elegir?

Para los desarrolladores que inician nuevos proyectos o migran desde iTextSharp, se aplican los siguientes factores:

Licencias: iTextSharp utiliza licencias AGPL para sus versiones más recientes, lo que requiere que su aplicación sea de código abierto o que adquiera una licencia comercial de iText Group. IronPDF ofrece licencias comerciales sencillas sin obligaciones de código abierto. Si su proyecto es de código cerrado o comercial, esta distinción por sí sola puede determinar su elección.

Curva de aprendizaje: El enfoque basado en HTML de IronPDF implica menos tiempo aprendiendo las API específicas de PDF. Si su equipo conoce HTML y CSS, la generación de PDF con IronPDF comienza de inmediato. No es necesario estudiar los sistemas de coordenadas de PDF, la codificación de glifos o la incrustación de fuentes: IronPDF maneja todo eso de manera transparente.

Cobertura de funciones: IronPDF admite compatibilidad con PDF/A , llenado de formularios , marcas de agua , y más, todo desde un único paquete NuGet . También se incluyen funciones avanzadas como firmas digitales y fusión de PDF sin dependencias adicionales.

Ruta de migración: pasar de iTextSharp a IronPDF implica reemplazar el código de manipulación de documentos con plantillas HTML y actualizar la llamada de representación. La calidad de salida suele ser mayor porque IronPDF utiliza un motor de navegador completo y el código resultante es significativamente más corto y más fácil de mantener.

Para obtener información sobre cómo funcionan los motores de renderizado de PDF y qué los diferencia, la documentación de Mozilla sobre PDF y los recursos de especificación de PDF de Adobe proporcionan un contexto útil. El sitio oficial de iText Group describe los términos AGPL en detalle.

¿Cuales son tus próximos pasos?

Para comenzar a utilizar IronPDF en su proyecto ASP.NET :

1. Instala el paquete NuGet: Install-Package IronPdf
2. Añade using IronPdf; a tu archivo
3. Crea un ChromePdfRenderer y llama a RenderHtmlAsPdf() con tu HTML
4. Devuelve pdf.BinaryData como un FileResult desde tu controlador

Explora estos recursos para ir más allá:

• Documentación HTML a PDF de IronPDF : opciones de renderizado completas y ejemplos
• Guía de generación de PDF de ASP.NET Core : patrones de controlador y representación de vistas de Razor
• Seguridad y cifrado de PDF : protección con contraseña y permisos
• Fusión y división de PDF : combinación de varios documentos
• Prueba gratuita de IronPDF : prueba todas las funciones sin marca de agua durante el desarrollo