La trampa de la licencia AGPL

iText presenta graves riesgos legales y empresariales para las aplicaciones comerciales que muchos equipos de desarrollo descubren demasiado tarde:

1. Licencia Viral AGPL: Si utiliza iText en una aplicación web, la AGPL le exige que abra el código fuente de TODA su aplicación, no sólo del código PDF, sino de toda su base de código. Esto es imposible para la mayoría del software comercial.

2. Sin licencia perpetua: iText ha eliminado las licencias perpetuas, que obligan a renovaciones anuales de la suscripción que aumentan el coste total de propiedad.

3. Coste del complemento pdfHTML: La funcionalidad de HTML a PDF requiere el complemento pdfHTML, que se vende por separado con un coste adicional a la licencia básica.

4. Auditorías de licencias complejas: las implantaciones empresariales se enfrentan a la complejidad de las licencias y al riesgo de auditorías que pueden retrasar los proyectos y crear riesgos legales.

5. API sólo programática: iText requiere la construcción manual de PDF de bajo nivel con objetos <código>Párrafo</código>, <código>Tabla</código>, <código>Celda</código>, lo que resulta tedioso y propenso a errores para diseños complejos.

6. Renderizado web moderno limitado: incluso con pdfHTML, el contenido CSS y JavaScriptcomplejo requiere un esfuerzo adicional significativo.

Comparación entre iText e IronPDF

Para los equipos que planifican la adopción de .NET 10 y C# 14 hasta 2025 y 2026,IronPDFproporciona una base preparada para el futuro con su enfoque basado en HTML que aprovecha las habilidades de desarrollo web que su equipo ya tiene.

Esfuerzo estimado por función

Cambio de paradigma

El cambio fundamental en esta migración de iText es de la construcción programática de PDF a la presentación de HTML en primer lugar:

using IronPdf; iText: PdfWriter → PdfDocument → Document → Add(Paragraph) → Add(Table) IronPDF: ChromePdfRenderer → RenderHtmlAsPdf(htmlString) → SaveAs() using IronPdf;

Este cambio de paradigma es liberador: en lugar de aprender el modelo de objetos de iText, se utilizan los conocimientos de HTML y CSS que ya poseen los desarrolladores web.

Prerrequisitos

1. <Entorno .NET: .NET Framework 4.6.2+ o .NET Core 3.1+ / .NET 5/6/7/8/9+
2. Acceso a NuGet: Capacidad para instalar paquetes NuGet
3. Licencia IronPDF: Obtenga su clave de licencia en ironpdf.com

Cambios en el paquete NuGet

Clases

clase iText 7	clase iTextSharp	Equivalente de IronPDF
<código>PdfWriter</código	<código>PdfWriter</código	<código>ChromePdfRenderer</código
Documento PDF	Documento	Documento PDF
Documento	Documento	<código>ChromePdfRenderer.RenderHtmlAsPdf()</código
Párrafo	Párrafo	HTML <p>, <h1>, etc.
<código>Tabla</código	Tabla PDF	HTML <código></código>
Célula	PdfPCell	HTML <td>, <th>
Imagen	Imagen	HTML <código></código>
<código>PdfReader</código	<código>PdfReader</código	<código>PdfDocument.FromFile()</código
<código>PdfMerger</código	N/A	PdfDocument.Merge()

Mapeo de espacios de nombres

Ejemplo 1: Conversión de HTML a PDF

Antes (iText 7):

using IronPdf;csharp // NuGet: Install-Package itext7 using iText.Html2pdf; using System.IO;

class Program { static void Main() { string html = "

Hello World

This is a PDF from HTML.

    using (FileStream fs = new FileStream(outputPath, FileMode.Create))
    {
        HtmlConverter.ConvertToPdf(html, fs);
    }
}

} using IronPdf;

Después (IronPDF):

using IronPdf;csharp // NuGet: Install-Package IronPdf using IronPdf;

class Program { static void Main() { var renderer = new ChromePdfRenderer(); string html = "

Hello World

This is a PDF from HTML.

    var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs("output.pdf");
}

} using IronPdf;

El enfoque iText requiere el paquete independiente iText.Html2pdf (complemento pdfHTML, se vende por separado), la creación de un FileStream y envolver todo en declaraciones using para su correcta eliminación. El método HtmlConverter.ConvertToPdf() escribe directamente en el flujo.

El enfoque deIronPDFes más limpio: crear un ChromePdfRenderer, llamar a RenderHtmlAsPdf() con su cadena HTML, y llamar a SaveAs() en el Documento PDFresultante. El motor de renderizado Chromium proporciona una compatibilidad superior con CSS3 y JavaScript. Consulte la documentación HTML a PDF para obtener más opciones de conversión.

Ejemplo 2: Combinar varios PDF

Antes (iText 7):

using IronPdf;csharp // NuGet: Install-Package itext7 using iText.Kernel.Pdf; using iText.Kernel.Utils; using System.IO;

class Program { static void Main() { string outputPath = "merged.pdf"; string[] inputFiles = { "document1.pdf", "document2.pdf", "document3.pdf" };

    using (PdfWriter writer = new PdfWriter(outputPath))
    using (PdfDocument pdfDoc = new PdfDocument(writer))
    {
        PdfMerger merger = new PdfMerger(pdfDoc);

        foreach (string file in inputFiles)
        {
            using (PdfDocument sourcePdf = new PdfDocument(new PdfReader(file)))
            {
                merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages());
            }
        }
    }
}

} using IronPdf;

Después (IronPDF):

using IronPdf;csharp // NuGet: Install-Package IronPdf using IronPdf; using System.Collections.Generic;

class Program { static void Main() { var pdfDocuments = new List{ PdfDocument.FromFile("document1.pdf"), PdfDocument.FromFile("document2.pdf"), PdfDocument.FromFile("document3.pdf") };

    var merged = PdfDocument.Merge(pdfDocuments);
    merged.SaveAs("merged.pdf");
}

} using IronPdf;

La operación de fusión de iText requiere una gran cantidad de repeticiones: crear un <código>PdfWriter</códigopara la salida, envolverlo en un PdfDocument, crear un <código>PdfMerger</códigoy, a continuación, iterar a través de los archivos de origen con sentencias using anidadas para cada Documento PDFy PdfReader. También debe especificar rangos de páginas con merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages()).

IronPDF reduce esto a tres pasos: cargar documentos con PdfDocument.FromFile(), llamar al método estático PdfDocument.Merge()con la lista, y guardar. Toda la operación de fusión debe ser legible y fácil de mantener. Más información sobre mezclar y dividir archivos PDF.

Ejemplo 3: Crear PDF con texto e imágenes

Antes (iText 7):

using IronPdf;csharp // NuGet: Install-Package itext7 using iText.Kernel.Pdf; using iText.Layout; using iText.Layout.Element; using iText.IO.Image;

class Program { static void Main() { string outputPath = "document.pdf";

    using (PdfWriter writer = new PdfWriter(outputPath))
    using (PdfDocument pdf = new PdfDocument(writer))
    using (Document document = new Document(pdf))
    {
        document.Add(new Paragraph("Sample PDF Document"));
        document.Add(new Paragraph("This document contains text and an image."));

        Image img = new Image(ImageDataFactory.Create("image.jpg"));
        img.SetWidth(200);
        document.Add(img);
    }
}

} using IronPdf;

Después (IronPDF):

using IronPdf;csharp // NuGet: Install-Package IronPdf using IronPdf;

class Program { static void Main() { var renderer = new ChromePdfRenderer();

    string html = @"
        <h1>Sample PDF Document</h1>
        <p>This document contains text and an image.</p>
        <img src='image.jpg' width='200' />";

    var pdf = renderer.RenderHtmlAsPdf(html);
    pdf.SaveAs("document.pdf");
}

} using IronPdf;

Este ejemplo ilustra el cambio de paradigma con mayor claridad. iText requiere:

• Sentencias using anidadas tres veces (PdfWriter, PdfDocument, Document)
• Creación de objetos Párrafopara cada elemento de texto con new Paragraph()
• Uso de ImageDataFactory.Create() para cargar imágenes
• Creación de un objeto Imageny llamada a SetWidth() por separado
• Llamada a document.Add() para cada elemento

IronPDF utiliza HTML estándar: <h1> para los títulos, <p> para los párrafos y <img> para las imágenes con un atributo width. Los desarrolladores web pueden aprovechar inmediatamente sus conocimientos, y los diseñadores pueden dar estilo a los documentos utilizando CSS que ya conocen.

Cambio de paradigma: De programático a HTML-First

El cambio más significativo en esta migración de iText es conceptual. iText crea archivos PDF mediante programación:

using IronPdf;csharp // iText approach document.Add(new Paragraph("Title") .SetTextAlignment(TextAlignment.CENTER) .SetFontSize(24) .SetBold());

var table = new Table(UnitValue.CreatePercentArray(3)).UseAllAvailableWidth(); table.AddHeaderCell(new Cell().Add(new Paragraph("ID"))); table.AddHeaderCell(new Cell().Add(new Paragraph("Name"))); // ... many more lines using IronPdf;

IronPDF utiliza HTML y CSS:

using IronPdf;csharp //IronPDFapproach string html = @"

<h1>Title</h1>
<table>
    <tr><th>ID</th><th>Name</th></tr>
</table>";

var pdf = renderer.RenderHtmlAsPdf(html); using IronPdf;

Licencia AGPL eliminada

la licencia AGPL de iText requiere que toda la aplicación web sea de código abierto o que se adquiera una costosa licencia comercial. La licencia comercial deIronPDFpermite la implementación en software propietario sin requisitos de licencia viral.

No requiere complemento pdfHTML

iText requiere el complemento pdfHTML para la conversión de HTML a PDF, que se vende por separado y tiene un coste adicional.IronPDFincluye el renderizado HTML completo basado en Chromium en el paquete base.

Patrones de sustitución de métodos

Número 1: PdfWriter/Patrón de documento

Problema: El código utiliza el patrón de anidación <código>PdfWriter</código→ Documento PDF→ Document.

Solución: Sustituir por ChromePdfRenderer:

using IronPdf;csharp // Delete this iText pattern: // using (var writer = new PdfWriter(outputPath)) // using (var pdfDoc = new PdfDocument(writer)) // using (var document = new Document(pdfDoc))

// Replace with: var renderer = new ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf(html); pdf.SaveAs(outputPath); using IronPdf;

Número 2: HtmlConverter Not Found

Problema: El código utiliza iText.Html2pdf.HtmlConverter que requiere el complemento pdfHTML.

Solución: Utilizar el renderizado HTML integrado de IronPDF:

using IronPdf;csharp // iText (requires pdfHTML add-on) HtmlConverter.ConvertToPdf(html, fileStream);

//IronPDF(built-in) var pdf = renderer.RenderHtmlAsPdf(html); pdf.SaveAs(outputPath); using IronPdf;

Número 3: Complejidad de PdfMerger

Problema: <código>PdfMerger</códigode iText requiere lectores anidados y especificación de rango de páginas.

Solución: Utilizar el método de fusión estática de IronPDF:

using IronPdf;csharp // iText merger pattern (delete this) // using (PdfDocument pdfDoc = new PdfDocument(writer)) // { // PdfMerger merger = new PdfMerger(pdfDoc); // foreach (string file in inputFiles) // { // using (PdfDocument sourcePdf = new PdfDocument(new PdfReader(file))) // { // merger.Merge(sourcePdf, 1, sourcePdf.GetNumberOfPages()); // } // } // }

//IronPDF(simple) var merged = PdfDocument.Merge(pdfDocuments); merged.SaveAs("merged.pdf"); using IronPdf;

Pre-Migración

• [ ] Inventario de todas las llamadas a la API de iText en el código base
• [ ] Identificar patrones programáticos de construcción de PDF (Párrafo, Tabla, Celda)
• [ ] Uso de Document HtmlConverter (complemento pdfHTML)
• [ ] Evaluar el riesgo de cumplimiento de la AGPL
• [ ] Obtener la clave de licencia de IronPDF

Migración de código

• [ ] Eliminar paquetes NuGet de iText: dotnet remove paquete itext7
• [ ] Instalar el paquete NuGet IronPdf: dotnet add package IronPdf
• [ ] Actualizar las importaciones de espacios de nombres (usando iText.* → usando IronPDF)
• [Reemplazar el patrón PdfWriter/Document por ChromePdfRenderer
• [ ] Convertir Párrafo/Tabla/Celda a elementos HTML
• [Reemplace HtmlConverter.ConvertToPdf() por RenderHtmlAsPdf()
• [Actualizar las operaciones de fusión a PdfDocument.Merge()
• [ ] Añadir inicialización de clave de licencia al inicio

Pruebas

• [ ] Probar todas las rutas de generación de PDF
• [Verificar que el resultado visual se ajuste a las expectativas
• [ ] Prueba con contenido HTML/CSS complejo
• [Rendimiento de referencia

Posmigración

• [ ] Eliminar archivos de licencia y referencias de iText
• [ ] Actualización de la documentación
• [ ] Cancelar suscripción a iText (si procede)
• [ ] Archivar código iText heredado