Clases

Métodos

Mapeo de propiedades de ConversionOptions

Mapeo de marcadores

Ejemplo 1: HTML básico a PDF

Antes (Kaizen.io):

using IronPdf;csharp using Kaizen.IO; using System.IO;

class Program { static void Main() { var converter = new HtmlToPdfConverter(); var html = "

Hello World

Después (IronPDF):

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

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

Hello World

El enfoque de Kaizen.io crea un HtmlToPdfConverter, llama a Convert() para obtener una matriz de bytes y, a continuación, escribe manualmente los bytes en un archivo mediante File.WriteAllBytes(). Esto implica un viaje de ida y vuelta en red al servicio en la nube de Kaizen.io.

El <código>ChromePdfRendererdeIronPDFprocesa todo localmente. El métodoRenderHtmlAsPdf()devuelve un objetoPdfDocumentcon un práctico métodoSaveAs()`, sin necesidad de manipulación manual de matrices de bytes ni latencia de red. Consulte la documentación HTML a PDF para obtener más opciones de conversión.

Ejemplo 2: Archivo HTML a PDF con configuración de página

Antes (Kaizen.io):

using IronPdf;csharp using Kaizen.IO; using System; using System.IO;

class Program { static void Main() { var converter = new HtmlToPdfConverter(); var htmlContent = File.ReadAllText("input.html"); var options = new ConversionOptions { PageSize = PageSize.A4, Orientation = Orientation.Portrait }; var pdfBytes = converter.Convert(htmlContent, options); File.WriteAllBytes("document.pdf", pdfBytes); } } using IronPdf;

Después (IronPDF):

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

class Program { static void Main() { var renderer = new ChromePdfRenderer(); renderer.RenderingOptions.PaperSize = PdfPaperSize.A4; renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait; var pdf = renderer.RenderHtmlFileAsPdf("input.html"); pdf.SaveAs("document.pdf"); } } using IronPdf;

El enfoque de Kaizen.io requiere leer manualmente el contenido del archivo HTML con File.ReadAllText(), crear un objeto <código>ConversionOptionsindependiente, pasar ambos al métodoConvert()` y, a continuación, escribir manualmente los bytes resultantes en un archivo.

IronPDF proporciona un método RenderHtmlFileAsPdf() dedicado que lee el archivo directamente, sin necesidad de lectura manual. La configuración se establece en la propiedad RenderingOptions del renderizador, manteniendo todos los ajustes en un solo lugar. Los enums PdfPaperSize.A4 y PdfPaperOrientation.Portrait se mapean directamente desde los equivalentes de Kaizen.io.

Ejemplo 3: URL a PDF con encabezados y pies de página

Antes (Kaizen.io):

using IronPdf;csharp using Kaizen.IO; using System; using System.IO;

class Program { static void Main() { var converter = new HtmlToPdfConverter(); var options = new ConversionOptions { Header = new HeaderOptions { HtmlContent = "

Después (IronPDF):

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

class Program { static void Main() { var renderer = new ChromePdfRenderer(); renderer.RenderingOptions.TextHeader.CenterText = "Company Header"; renderer.RenderingOptions.TextFooter.CenterText = "Page {page} of {total-pages}"; renderer.RenderingOptions.MarginTop = 20; renderer.RenderingOptions.MarginBottom = 20; var pdf = renderer.RenderUrlAsPdf("https://example.com"); pdf.SaveAs("webpage.pdf"); } } using IronPdf;

Este ejemplo muestra varias diferencias clave en la migración. Kaizen.io requiere objetos <código>HeaderOptionsy <código>FooterOptions</code>anidados dentro deConversionOptions, cada uno con una propiedadHtmlContent.IronPDFproporciona una configuración más limpia deTextHeaderyTextFootercon propiedadesCenterText,LeftTextyRightText` dedicadas.

Nota crítica: ¡La sintaxis del marcador de posición es diferente! Kaizen.io utiliza {total}para el recuento total de páginas, mientras queIronPDFutiliza {total-pages}. Este es el problema de migración más común: busque {total}en su código base y sustitúyalo por {total-pages}.

El método RenderUrlAsPdf() deIronPDFrenderiza directamente cualquier URL con ejecución completa de JavaScripta través del motor Chromium, sin necesidad de recurrir a ninguna solución. Más información sobre conversión de URL a PDF y encabezados y pies de página.

Cambio en la sintaxis de los marcadores

El cambio más importante al migrar encabezados y pies de página es la sintaxis de los marcadores de posición:

using IronPdf;csharp // Kaizen.io placeholders: "Page {page} of {total}"

//IronPDFplaceholders: "Page {page} of {total-pages}" using IronPdf;

Mapeo completo de marcadores de posición:

• {page}→ {page}(igual)
• {total}→ {total de páginas}(¡DIFERENTE!)
• {title}→ {html-title}(¡DIFERENTE!)
• {fecha} → {fecha} (igual)
• {time} → {time} (igual)

Cambio de tipo de retorno

Kaizen.io devuelve byte[] directamente.IronPDFdevuelve un objeto PdfDocument:

using IronPdf;csharp // Kaizen.io returns byte[] byte[] pdfBytes = converter.Convert(html); File.WriteAllBytes("output.pdf", pdfBytes);

//IronPDFreturns PdfDocument var pdf = renderer.RenderHtmlAsPdf(html); pdf.SaveAs("output.pdf"); // Direct save byte[] bytes = pdf.BinaryData; // Or get bytes if needed using IronPdf;

Quitar la gestión de claves de API

Kaizen.io requiere autenticación de clave API por solicitud.IronPDFutiliza una clave de licencia que se establece una vez al iniciar la aplicación:

using IronPdf;csharp // DELETE this Kaizen.io pattern: var converter = new HtmlToPdfConverter("YOUR_API_KEY");

// IronPDF: Set once at startup IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"; var renderer = new ChromePdfRenderer(); // No API key needed using IronPdf;

Borrar la gestión de errores de red

Elimine la lógica de reintento, la gestión del límite de velocidad y el código de tiempo de espera de la red:IronPDFprocesa localmente:

using IronPdf;csharp // DELETE this Kaizen.io pattern: int retries = 3; while (retries > 0) { try { return converter.Convert(html); } catch (RateLimitException) { retries--; Thread.Sleep(1000); } }

// IronPDF: Just call the method return renderer.RenderHtmlAsPdf(html).BinaryData; using IronPdf;

Asunto 1: HtmlToPdfConverter no encontrado

Problema: la clase <código>HtmlToPdfConverter`no existe en IronPDF.

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

using IronPdf;csharp // Kaizen.io var converter = new HtmlToPdfConverter();

// IronPDF var renderer = new ChromePdfRenderer(); using IronPdf;

Asunto 2: ConversionOptions Not Found

Problema: la clase <código>ConversionOptionsno existe en IronPDF.

Solución: utilice RenderingOptions en el renderizador:

using IronPdf;csharp // Kaizen.io var options = new ConversionOptions { PageSize = PageSize.A4 }; converter.Convert(html, options);

// IronPDF renderer.RenderingOptions.PaperSize = PdfPaperSize.A4; renderer.RenderHtmlAsPdf(html); using IronPdf;

Asunto 3: Los números de página no funcionan

Problema: el pie de página muestra literalmente {total}en lugar del recuento de páginas.

Solución: Actualizar la sintaxis del marcador de posición:

using IronPdf;csharp // Kaizen.io syntax (won't work) "Page {page} of {total}"

//IronPDFsyntax "Page {page} of {total-pages}" using IronPdf;

Edición 4: Método de conversión no encontrado

Problema: el método Convert() no existe en <código>ChromePdfRenderer`.

Solución: utilice RenderHtmlAsPdf() :

using IronPdf;csharp // Kaizen.io var pdfBytes = converter.Convert(html);

// IronPDF var pdf = renderer.RenderHtmlAsPdf(html); var pdfBytes = pdf.BinaryData; using IronPdf;

Número 5: Primera renderización lenta

Problema: la primera generación de PDF tarda entre 1 y 3 segundos.

Solución:IronPDFinicializa Chromium en el primer uso. Calentamiento al inicio de la aplicación:

using IronPdf;csharp // In Program.cs or Startup.cs: new ChromePdfRenderer().RenderHtmlAsPdf(""); using IronPdf;

Pre-Migración

• Identificar todos los Kaizen.io using declaraciones
• Configuración de <código>ConversionOptions`de documentos utilizada
• Plantillas de encabezado/pie de página y marcadores de posición de notas
• Lista de ubicaciones de claves API (para eliminar)
• Verificar la lógica de reintento/límite de velocidad (para eliminar)
• Obtener la clave de licencia de IronPDF

Cambios en el paquete

• Eliminar el paquete Kaizen.HtmlToPdf
• Instalar el paquete NuGet IronPdf : dotnet add package IronPdf
• Actualizar las importaciones de espacios de nombres

Cambios de código

• Agregar configuración de clave de licencia al inicio
• Reemplace <código>HtmlToPdfConverterconChromePdfRenderer`
• Convertir <código>ConversionOptionsenRenderingOptions`
• Actualizar Convert() a RenderHtmlAsPdf()
• Actualizar ConvertUrl() a RenderUrlAsPdf()
• Actualizar la sintaxis del marcador de posición ( {total}→ {total de páginas})
• Reemplace File.WriteAllBytes() con pdf.SaveAs()
• Eliminar la configuración de la clave API
• Eliminar la lógica de reintento/límite de velocidad
• Eliminar el manejo de errores de red para llamadas API

Pruebas

• Probar todas las rutas de generación de PDF
• Verificar la representación del encabezado/pie de página
• Verificar la representación del marcador de posición
• Validar márgenes y tamaños de página
• Pruebe la funcionalidad sin conexión (¡nueva capacidad!)
• Mejora del rendimiento de referencia

Posmigración

• Eliminar la clave API de Kaizen.io de la configuración
• Actualizar las variables de entorno
• Eliminar la configuración del límite de velocidad
• Monitoreo/alerta de actualizaciones