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 anidamiento <código>PdfWriter</código→ Documento PDF→ Documento.

Solución: Reemplazar con <código>ChromePdfRenderer</código:

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: utilice la representación HTML integrada 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: utilice el método de combinació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

• Inventariar todas las llamadas API de iText en el código base
• Identificar patrones de construcción de PDF programáticos (párrafo, tabla, celda)
• Uso de Document HtmlConverter (complemento pdfHTML)
• Evaluar el riesgo de incumplimiento de AGPL
• Obtener la clave de licencia de IronPDF

Migración de código

• Eliminar paquetes NuGet de iText: dotnet remove package itext7
• Instalar el paquete NuGet IronPdf: dotnet add package IronPdf
• Actualizar las importaciones del espacio de nombres ( using iText.* → using IronPdf )
• Reemplazar el patrón <código>PdfWriter</código/ Documentocon ChromePdfRenderer
• Convertir Párrafo/ <código>Tabla</código/ Célulaen elementos HTML
• Reemplace HtmlConverter.ConvertToPdf() con RenderHtmlAsPdf()
• Actualizar las operaciones de fusión a PdfDocument.Merge()
• Agregar inicialización de clave de licencia al inicio

Pruebas

• Probar todas las rutas de generación de PDF
• Verificar que el resultado visual coincida con 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 la suscripción a iText (si corresponde)
• Archivar código heredado de iText