Ícono de mensaje
Saltar al pie de página
  1. IronPDF
  2. Blog de IronPDF
  3. Guías de migración
  4. migración de zetpdf a ironpdf
GUíAS DE MIGRACIóN

Cómo migrar de ZetPDF a IronPDF en C#

Curtis Chau
Curtis Chau
Publicado:

ZetPDF es una biblioteca PDF con licencia comercial para aplicaciones C# creada sobre la base de la biblioteca PDFSharp de código abierto ampliamente utilizada. Aunque ZetPDFofrece soporte comercial y capacidades básicas de manipulación de PDF, hereda importantes limitaciones de su base PDFSharp. En particular, la biblioteca se basa en la programación de gráficos por coordenadas y ofrece capacidades limitadas de conversión de HTML a PDF en comparación con las alternativas modernas.

Esta guía proporciona una ruta de migración completa de ZetPDFa IronPDF, con instrucciones paso a paso, comparaciones de código y ejemplos prácticos para desarrolladores .NET profesionales que estén evaluando esta transición.

Por qué migrar de ZetPDF

ZetPDF, como bifurcación de PDFSharp, hereda las mismas restricciones arquitectónicas que limitan su eficacia para los flujos de trabajo modernos de generación de documentos. Entre las principales razones por las que los equipos de desarrollo se plantean la migración se incluyen:

API basada en coordenadas: ZetPDFobliga a los desarrolladores a posicionar cada elemento con coordenadas exactas. La compleja colocación manual de cada elemento plantea problemas de mantenimiento a medida que cambian los requisitos.

Compatibilidad limitada con CSS: la falta de un sistema de estilo implica una gestión manual de fuentes y colores para cada elemento.

Sin representación de JavaScript: no se puede representar contenido web dinámico ni ejecutar JavaScript durante la generación de PDF.

Ofertas únicas limitadas: en comparación con el uso directo de PDFSharp sin costo, ZetPDFofrece pocas razones convincentes que requieran su licencia comercial.

Saltos de página manuales: se debe calcular y gestionar el desbordamiento de página manualmente en lugar de depender de la paginación automática.

Se requiere medición de texto: el cálculo manual para el ajuste de texto crea una sobrecarga de desarrollo adicional.

El problema fundamental

ZetPDF y PDFSharp obligan a posicionar cada elemento con coordenadas exactas:

// ZetPDF: Manualpositioning nightmare
graphics.DrawString("Name:", font, brush, new XPoint(50, 100));
graphics.DrawString("John Doe", font, brush, new XPoint(100, 100));
graphics.DrawString("Address:", font, brush, new XPoint(50, 120));
graphics.DrawString("123 Main St", font, brush, new XPoint(100, 120));
// ... hundreds of lines for a simple form
// ZetPDF: Manualpositioning nightmare
graphics.DrawString("Name:", font, brush, new XPoint(50, 100));
graphics.DrawString("John Doe", font, brush, new XPoint(100, 100));
graphics.DrawString("Address:", font, brush, new XPoint(50, 120));
graphics.DrawString("123 Main St", font, brush, new XPoint(100, 120));
// ... hundreds of lines for a simple form
$vbLabelText   $csharpLabel

IronPDF utiliza HTML/CSS: el motor de diseño se encarga de todo:

// IronPDF: Simple HTML
var html = @"
<p><strong>Name:</strong> John Doe</p>
<p><strong>Address:</strong> 123 Main St</p>";
var pdf = renderer.RenderHtmlAsPdf(html);
// IronPDF: Simple HTML
var html = @"
<p><strong>Name:</strong> John Doe</p>
<p><strong>Address:</strong> 123 Main St</p>";
var pdf = renderer.RenderHtmlAsPdf(html);
$vbLabelText   $csharpLabel

IronPDFfrente a ZetPDF: Comparación de características

Comprender las diferencias arquitectónicas ayuda a los responsables técnicos a evaluar la inversión en migración:

Característica ZetPDF IronPDF
Basado en PDFSharp Sí No
Conversión de HTML a PDF Limitado Sí (Chromium completo)
Licencia comercial Sí, Perpetual Sí
Fundación Código Abierto PDFSharp (Licencia MIT) Basado en Chromium
Soporte CSS No CSS3 completo
JavaScript No ES2024 completo
Diseño automático No Sí
Saltos de página automáticos No Sí
Tablas Dibujo manual HTML <código>`
Cabeceras/Pies de página Manual HTML/CSS
Marcas de agua Código del manual Incorporado en
Fusionar PDF Limitado Sí
Dividir PDF Limitado Sí
Firmas digitales No Sí
PDF/A No Sí
Simplicidad y facilidad de uso Moderado Alta

Inicio rápido: Migración de ZetPDFa IronPDF

La migración puede comenzar inmediatamente con estos pasos básicos.

Paso 1: Sustituir el paquete NuGet

Eliminar ZetPDF:

# Remove ZetPDF
dotnet remove package ZetPDF
# Remove ZetPDF
dotnet remove package ZetPDF
SHELL

Instalar IronPDF:

# Install IronPDF
dotnet add package IronPdf
# Install IronPDF
dotnet add package IronPdf
SHELL

Paso 2: Actualizar los espacios de nombres

Sustituya los espacios de nombres ZetPDFpor el espacio de nombres IronPdf:

// Before (ZetPDF)
using ZetPdf;
using ZetPdf.Drawing;
using ZetPdf.Fonts;

// After (IronPDF)
using IronPdf;
// Before (ZetPDF)
using ZetPdf;
using ZetPdf.Drawing;
using ZetPdf.Fonts;

// After (IronPDF)
using IronPdf;
$vbLabelText   $csharpLabel

Paso 3: Inicializar licencia

Añadir inicialización de licencia al inicio de la aplicación:

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
$vbLabelText   $csharpLabel

Ejemplos de migración de código

Convertir HTML a PDF

La operación de HTML a PDF demuestra las diferencias de API entre estas bibliotecas PDF .NET.

Enfoque ZetPDF:

// NuGet: Install-Package ZetPDF
using ZetPDF;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        converter.ConvertHtmlToPdf(htmlContent, "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}
// NuGet: Install-Package ZetPDF
using ZetPDF;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        converter.ConvertHtmlToPdf(htmlContent, "output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}
$vbLabelText   $csharpLabel

Enfoque IronPDF:

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}
$vbLabelText   $csharpLabel

ZetPDF utiliza <código>HtmlToPdfConvertercon <código>ConvertHtmlToPdf()</code>que escribe directamente en una ruta de archivo.IronPDFproporciona <código>ChromePdfRenderer</code>con <código>RenderHtmlAsPdf()</code>que devuelve un objetoPdfDocument`, dándole más flexibilidad con la salida: puede guardar en un archivo, obtener datos binarios o realizar operaciones adicionales antes de guardar.

Para situaciones avanzadas de conversión de HTML a PDF, consulte la Guía de conversión de HTML a PDF.

Convertir URL en PDF

La conversión de URL a PDF muestra claramente las diferencias de patrón.

Enfoque ZetPDF:

// NuGet: Install-Package ZetPDF
using ZetPDF;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var url = "https://www.example.com";
        converter.ConvertUrlToPdf(url, "webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}
// NuGet: Install-Package ZetPDF
using ZetPDF;
using System;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var url = "https://www.example.com";
        converter.ConvertUrlToPdf(url, "webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}
$vbLabelText   $csharpLabel

Enfoque IronPDF:

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var url = "https://www.example.com";
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var url = "https://www.example.com";
        var pdf = renderer.RenderUrlAsPdf(url);
        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL created successfully");
    }
}
$vbLabelText   $csharpLabel

ZetPDF utiliza la misma clase <código>HtmlToPdfConverterconConvertUrlToPdf().IronPDFproporciona <código>RenderUrlAsPdf()en ChromePdfRenderer, que aprovecha un motor de renderizado Chromium completo para la captura precisa de páginas web, incluida la ejecución de JavaScript y CSS moderno.

Explore la URL a la documentación PDF para conocer las opciones de autenticación y encabezado personalizado.

Fusión de varios PDF

La fusión de PDF revela importantes diferencias de API en el tratamiento de los documentos.

Enfoque ZetPDF:

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

class Program
{
    static void Main()
    {
        var merger = new PdfMerger();
        var files = new List<string> { "document1.pdf", "document2.pdf" };
        merger.MergeFiles(files, "merged.pdf");
        Console.WriteLine("PDFs merged successfully");
    }
}
// NuGet: Install-Package ZetPDF
using ZetPDF;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var merger = new PdfMerger();
        var files = new List<string> { "document1.pdf", "document2.pdf" };
        merger.MergeFiles(files, "merged.pdf");
        Console.WriteLine("PDFs merged successfully");
    }
}
$vbLabelText   $csharpLabel

Enfoque IronPDF:

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

class Program
{
    static void Main()
    {
        var pdfs = new List<PdfDocument>
        {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf")
        };
        var merged = PdfDocument.Merge(pdfs);
        merged.SaveAs("merged.pdf");
        Console.WriteLine("PDFs merged successfully");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var pdfs = new List<PdfDocument>
        {
            PdfDocument.FromFile("document1.pdf"),
            PdfDocument.FromFile("document2.pdf")
        };
        var merged = PdfDocument.Merge(pdfs);
        merged.SaveAs("merged.pdf");
        Console.WriteLine("PDFs merged successfully");
    }
}
$vbLabelText   $csharpLabel

ZetPDF utiliza una clase <código>PdfMergerdedicada que opera sobre rutas de archivos conMergeFiles().IronPDFcarga documentos como objetosPdfDocumentutilizandoPdfDocument.FromFile(), y luego los fusiona con el método estáticoPdfDocument.Merge()`. Este enfoque orientado a objetos permite realizar operaciones adicionales en el documento fusionado antes de guardarlo.

Explore la documentación sobre la fusión de PDF para conocer otras opciones de fusión.

Dibujo por coordenadas frente a HTML

Para los desarrolladores con código ZetPDFexistente que utilice gráficos basados en coordenadas, la ruta de migración implica convertir los comandos de dibujo a HTML/CSS.

Enfoque basado en coordenadas de ZetPDF:

using ZetPdf;
using ZetPdf.Drawing;

var document = new PdfDocument();
var page = document.AddPage();
page.Width = XUnit.FromMillimeter(210);
page.Height = XUnit.FromMillimeter(297);

var graphics = XGraphics.FromPdfPage(page);
var titleFont = new XFont("Arial", 24, XFontStyle.Bold);
var bodyFont = new XFont("Arial", 12);

graphics.DrawString("Company Report", titleFont, XBrushes.Navy,
    new XPoint(50, 50));
graphics.DrawString("This is the introduction paragraph.", bodyFont, XBrushes.Black,
    new XPoint(50, 80));
graphics.DrawString("Generated: " + DateTime.Now.ToString(), bodyFont, XBrushes.Gray,
    new XPoint(50, 100));

document.Save("report.pdf");
using ZetPdf;
using ZetPdf.Drawing;

var document = new PdfDocument();
var page = document.AddPage();
page.Width = XUnit.FromMillimeter(210);
page.Height = XUnit.FromMillimeter(297);

var graphics = XGraphics.FromPdfPage(page);
var titleFont = new XFont("Arial", 24, XFontStyle.Bold);
var bodyFont = new XFont("Arial", 12);

graphics.DrawString("Company Report", titleFont, XBrushes.Navy,
    new XPoint(50, 50));
graphics.DrawString("This is the introduction paragraph.", bodyFont, XBrushes.Black,
    new XPoint(50, 80));
graphics.DrawString("Generated: " + DateTime.Now.ToString(), bodyFont, XBrushes.Gray,
    new XPoint(50, 100));

document.Save("report.pdf");
$vbLabelText   $csharpLabel

Enfoque HTML de IronPDF:

using IronPdf;

var html = $@"
<html>
<head>
    <style>
        body {{ font-family: Arial, sans-serif; padding: 50px; }}
        h1 {{ color: navy; }}
        .date {{ color: gray; }}
    </style>
</head>
<body>
    <h1>Company Report</h1>
    <p>This is the introduction paragraph.</p>
    <p class='date'>Generated: {DateTime.Now}</p>
</body>
</html>";

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("report.pdf");
using IronPdf;

var html = $@"
<html>
<head>
    <style>
        body {{ font-family: Arial, sans-serif; padding: 50px; }}
        h1 {{ color: navy; }}
        .date {{ color: gray; }}
    </style>
</head>
<body>
    <h1>Company Report</h1>
    <p>This is the introduction paragraph.</p>
    <p class='date'>Generated: {DateTime.Now}</p>
</body>
</html>";

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("report.pdf");
$vbLabelText   $csharpLabel

El enfoque de ZetPDFrequiere crear objetos de fuente, calcular las posiciones exactas de los píxeles y gestionar manualmente el contexto gráfico. El enfoque deIronPDFutiliza HTML y CSS estándar que los desarrolladores web ya conocen: las fuentes, los colores y el diseño se gestionan mediante propiedades CSS familiares.

Referencia de la API de ZetPDFa IronPDF

Este mapeo acelera la migración al mostrar los equivalentes directos de las API:

ZetPDF IronPDF Notas
nuevo PdfDocument() <código>new ChromePdfRenderer()` Crear renderizador
document.AddPage() Automático Páginas creadas a partir de HTML
<código>XGraphics.FromPdfPage(page)` N/A Utilice HTML/CSSen su lugar
<código>graphics.DrawString() Elementos de texto HTML <p>, <h1>, etc.
<código>graphics.DrawImage()` <código> related to Referencia de la API de ZetPDFa IronPDF etiqueta Imágenes HTML
<código>graphics.DrawLine() Bordes CSS O <hr>
<código>graphics.DrawRectangle()| CSSborde+div` Cuadros HTML
nuevo XFont() CSS family Fuentes web compatibles
XBrushes.Black CSS color Soporte a todo color
document.Save() <código>pdf.SaveAs()` Guardar en archivo
<código>PdfReader.Open() <código>PdfDocument.FromFile() Cargar PDF existente
<código>HtmlToPdfConverter <código>ChromePdfRenderer Conversión de HTML
<código>ConvertHtmlToPdf() <código>RenderHtmlAsPdf() Cadena HTML a PDF
<código>ConvertUrlToPdf() <código>RenderUrlAsPdf() URL a PDF
<código>PdfMerger PdfDocument.Merge() Combinar PDF

Problemas comunes de migración y soluciones

Número 1: Diseño basado en coordenadas

ZetPDF: Todo requiere coordenadas X,Y exactas con posicionamiento manual.

Solución: Utilizar diseño de flujo HTML/CSS. Para el posicionamiento absoluto cuando sea necesario, utilice CSS:

.positioned-element {
    position: absolute;
    top: 100px;
    left: 50px;
}

Número 2: Gestión de objetos de fuentes

ZetPDF: Crea objetos XFont para cada variación de fuente.

Solución: Utilizar CSS font-family-las fuentes se manejan automáticamente:

<style>
    body { font-family: Arial, sans-serif; }
    h1 { font-family: 'Times New Roman', serif; font-size: 24px; font-weight: bold; }
</style>
<style>
    body { font-family: Arial, sans-serif; }
    h1 { font-family: 'Times New Roman', serif; font-size: 24px; font-weight: bold; }
</style>
HTML

Número 3: Manejo del color

ZetPDF: Utiliza XBrushes y objetos de color.

Solución: Utilizar colores CSS estándar:

.header { color: navy; background-color: #f5f5f5; }
.warning { color: rgb(255, 0, 0); }

Edición 4: Saltos de página manuales

ZetPDF: Rastrea la posición Y y crea nuevas páginas manualmente cuando el contenido se desborda.

Solución:IronPDFgestiona los saltos de página automáticos. Para un control explícito, utilice CSS:

.section { page-break-after: always; }
.keep-together { page-break-inside: avoid; }

Edición 5: Creación de tablas

ZetPDF: Requiere el dibujo manual de rectángulos, líneas y posicionamiento de texto.

Solución: Utilizar tablas HTML estándar con estilo CSS:

<table style="border-collapse: collapse; width: 100%;">
    <tr>
        <th style="border: 1px solid black; padding: 8px;">Header</th>
    </tr>
    <tr>
        <td style="border: 1px solid black; padding: 8px;">Data</td>
    </tr>
</table>
<table style="border-collapse: collapse; width: 100%;">
    <tr>
        <th style="border: 1px solid black; padding: 8px;">Header</th>
    </tr>
    <tr>
        <td style="border: 1px solid black; padding: 8px;">Data</td>
    </tr>
</table>
HTML

Lista de comprobación para la migración a ZetPDF

Tareas previas a la migración

Audite su código base para identificar todo el uso de ZetPDF:

grep -r "using ZetPDF" --include="*.cs" .
grep -r "HtmlToPdfConverter\|PdfMerger\|XGraphics" --include="*.cs" .
grep -r "using ZetPDF" --include="*.cs" .
grep -r "HtmlToPdfConverter\|PdfMerger\|XGraphics" --include="*.cs" .
SHELL

Documentar código de dibujo basado en coordenadas que necesite conversión a HTML. Tenga en cuenta los patrones de uso de fuentes y colores. Asignar estructuras de diseño a equivalentes HTML.

Tareas de actualización de código

  1. Eliminar el paquete NuGet de ZetPDF
  2. Instalación del paquete IronPdf NuGet
  3. Actualizar las importaciones de espacios de nombres de ZetPDF a IronPdf
  4. Sustituya <código>HtmlToPdfConverterporChromePdfRenderer`
  5. Convertir las llamadas <código>ConvertHtmlToPdf()en <código>RenderHtmlAsPdf()</code>+SaveAs()`
  6. Convertir las llamadas a <código>ConvertUrlToPdf()en <código>RenderUrlAsPdf()</code>+SaveAs()`
  7. Sustituya PdfMerger.MergeFiles() por PdfDocument.Merge()
  8. Convertir llamadas DrawString() en elementos de texto HTML
  9. Convertir XFont a family CSS
  10. Sustituir XBrushes por colores CSS
  11. Añadir la inicialización de la licenciaIronPDFal inicio

Pruebas posteriores a la migración

Tras la migración, verifique estos aspectos:

  • Comparar los resultados visuales para garantizar que el aspecto coincida o mejore
  • Verificar que las fuentes se muestran como se espera con el estilo CSS
  • Prueba de que los saltos de página se producen correctamente con la paginación automática
  • Comprobar que las imágenes están colocadas y se muestran correctamente
  • Prueba de que las operaciones de fusión de PDF producen resultados correctos
  • Confirmar que toda la funcionalidad existente funciona con la nueva implementación

Beneficios clave de migrar a IronPDF

El cambio de ZetPDFaIronPDFofrece varias ventajas fundamentales:

Motor de renderizado Chromium moderno:IronPDFutiliza Chromium para la conversión de HTML a PDF, lo que garantiza compatibilidad total con CSS3 y JavaScript ES2024. Los frameworks modernos y los diseños responsivos se traducen correctamente.

Creación de contenido basado en HTML: los desarrolladores web pueden aprovechar las habilidades existentes en HTML y CSS. No es necesario aprender API de dibujo basadas en coordenadas ni gestionar objetos de fuentes.

Diseño y paginación automáticos: el ajuste de texto, los saltos de página y el diseño de flujo se realizan automáticamente. Sin cálculo manual de las posiciones de los elementos.

API simplificada: llamadas de método único para operaciones comunes. PdfDocument.Merge()sustituye a los complejos patrones de gestión de rutas de archivos.

Desarrollo activo: a medida que aumenta la adopción de .NET 10 y C# 14 hasta 2026, las actualizaciones periódicas deIronPDFgarantizan la compatibilidad con las versiones actuales y futuras de .NET.

Conjunto completo de funciones: marca de agua integrada, firmas digitales, compatibilidad con PDF/A y funciones avanzadas de manipulación de PDF de las que carece ZetPDF.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más

Artículos Relacionados

Prueba de 30 días → Producto completo. Sin límites. Sin tarjeta. Prueba gratis