Cómo migrar de pdforge a IronPDF en C#

Entendiendo pdforge

pdforge es una API de generación de PDF basada en la nube, que ofrece una forma sencilla de producir archivos PDF mediante la integración con su aplicación a través de llamadas a la API. Al descargar la tarea de creación de PDF a una API externa, los desarrolladores pueden simplificar el proceso de desarrollo. Sin embargo, pdforgepresenta inconvenientes como dependencias externas, opciones de personalización limitadas y costes de suscripción continuos que los desarrolladores deben tener en cuenta.

El problema de la dependencia de la API de la nube

pdforge procesa todos los documentos en servidores externos en la nube. Esta arquitectura plantea problemas importantes para las aplicaciones de producción:

1. Procesamiento de servidor externo: cada PDF que genera requiere enviar su HTML/datos a los servidores de pdforge; sus documentos salen de su infraestructura.

2. Riesgos de privacidad y cumplimiento: los datos confidenciales viajan a través de Internet a servidores de terceros. Al utilizar pdforge, los desarrolladores deben tener en cuenta las cuestiones de seguridad relacionadas con el envío de datos a una API externa. Si el contenido del PDF incluye información sensible, esto podría ser una consideración crítica.

3. Costos de suscripción continuos: las tarifas mensuales se acumulan indefinidamente sin propiedad de activos. El modelo SaaS de pdforgeintroduce gastos operativos continuos que pueden acumularse con el tiempo.

4. Dependencia de Internet: no se genera PDF cuando la red no está disponible.

5. Límites de velocidad: los límites de uso de la API pueden limitar las aplicaciones de gran volumen.

6. Latencia de la red: el tiempo de ida y vuelta agrega segundos a cada generación de PDF.

Comparación entre PDForge e IronPDF

IronPDF se distingue por ofrecer una biblioteca totalmente local, que otorga a los desarrolladores un control total sobre el proceso de creación de PDF. Esto es especialmente ventajoso para aplicaciones en las que se prefiere el manejo interno de archivos, o en las que las llamadas a API externas introducen problemas de seguridad.IronPDFprocesa todo localmente, minimizando estos riesgos.

Para los equipos que planean la adopción de .NET 10 y C# 14 hasta 2025 y 2026,IronPDFproporciona una base de procesamiento local que elimina la dependencia de la nube a la vez que añade funciones completas de manipulación de PDF.

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 deIronPDF: Obtenga su clave de licencia en IronPDF

Cambios en el paquete NuGet

# Remove pdforgepackages
dotnet remove package pdforge
dotnet remove package PdfForge

# Install IronPDF
dotnet add package IronPdf

# Remove pdforgepackages
dotnet remove package pdforge
dotnet remove package PdfForge

# Install IronPDF
dotnet add package IronPdf

Configuración de licencias

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

' Add at application startup (Program.vb or Startup.vb)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"

Identificar el uso de pdforge

# Find pdforgeusage
grep -r "PdForge\|PdfClient\|HtmlToPdfRequest\|HtmlToPdfConverter" --include="*.cs" .

# Find placeholder patterns to migrate
grep -r "{totalPages}" --include="*.cs" .

# Find pdforgeusage
grep -r "PdForge\|PdfClient\|HtmlToPdfRequest\|HtmlToPdfConverter" --include="*.cs" .

# Find placeholder patterns to migrate
grep -r "{totalPages}" --include="*.cs" .

Cambios en el espacio de nombres

// Before: pdforge
using PdfForge;
using System.IO;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

// Before: pdforge
using PdfForge;
using System.IO;

// After: IronPDF
using IronPdf;
using IronPdf.Rendering;

' Before: pdforge
Imports PdfForge
Imports System.IO

' After: IronPDF
Imports IronPdf
Imports IronPdf.Rendering

Asignaciones de clases principales

Métodos

Mapas de configuración

Nuevas funciones no disponibles en pdforge

Ejemplo 1: Conversión de cadenas HTML a PDF

Antes (pdforge):

// NuGet: Install-Package PdfForge
using PdfForge;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = converter.ConvertHtmlString(html);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

// NuGet: Install-Package PdfForge
using PdfForge;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = converter.ConvertHtmlString(html);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

Imports PdfForge
Imports System.IO

Class Program
    Shared Sub Main()
        Dim converter = New HtmlToPdfConverter()
        Dim html = "<html><body><h1>Hello World</h1></body></html>"
        Dim pdf = converter.ConvertHtmlString(html)
        File.WriteAllBytes("output.pdf", pdf)
    End Sub
End Class

Después (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim html = "<html><body><h1>Hello World</h1></body></html>"
        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("output.pdf")
    End Sub
End Class

La diferencia fundamental en este caso es el modelo de procesamiento y el tipo de retorno. pdforgeusa HtmlToPdfConverter con ConvertHtmlString() que devuelve una matriz byte[]—luego debe usar File.WriteAllBytes() para guardar el resultado.

IronPDF utiliza ChromePdfRenderer con RenderHtmlAsPdf() que devuelve un objeto PdfDocument. Este objeto se puede guardar directamente con SaveAs(), o puede acceder a pdf.BinaryData si necesita los bytes sin procesar. El PdfDocument también permite la manipulación (agregar marcas de agua, fusionar con otros PDF, agregar seguridad) antes de guardar. Consulte la documentación HTML a PDF para ver ejemplos completos.

Ejemplo 2: Conversión de URL a PDF

Antes (pdforge):

// NuGet: Install-Package PdfForge
using PdfForge;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var pdf = converter.ConvertUrl("https://example.com");
        File.WriteAllBytes("webpage.pdf", pdf);
    }
}

// NuGet: Install-Package PdfForge
using PdfForge;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        var pdf = converter.ConvertUrl("https://example.com");
        File.WriteAllBytes("webpage.pdf", pdf);
    }
}

Imports PdfForge
Imports System.IO

Class Program
    Shared Sub Main()
        Dim converter = New HtmlToPdfConverter()
        Dim pdf = converter.ConvertUrl("https://example.com")
        File.WriteAllBytes("webpage.pdf", pdf)
    End Sub
End Class

Después (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
        pdf.SaveAs("webpage.pdf")
    End Sub
End Class

pdforge usa ConvertUrl() en la clase HtmlToPdfConverter, devolviendo bytes que escribe con File.WriteAllBytes().IronPDFusa RenderUrlAsPdf() en ChromePdfRenderer, devolviendo un PdfDocument con el método incorporado SaveAs().

La principal ventaja deIronPDFes que la URL se obtiene y se renderiza localmente mediante un motor Chromium, sin necesidad de enviar datos a servidores externos. IronPDF, al ser una biblioteca local, puede ofrecer un mejor rendimiento, ya que no hay tiempo de ida y vuelta en las solicitudes web. Más información sobre Conversión de URL a PDF.

Ejemplo 3: Archivo HTML a PDF con configuración personalizada

Antes (pdforge):

// NuGet: Install-Package PdfForge
using PdfForge;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.PageSize = PageSize.A4;
        converter.Orientation = PageOrientation.Landscape;
        var htmlContent = File.ReadAllText("input.html");
        var pdf = converter.ConvertHtmlString(htmlContent);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

// NuGet: Install-Package PdfForge
using PdfForge;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new HtmlToPdfConverter();
        converter.PageSize = PageSize.A4;
        converter.Orientation = PageOrientation.Landscape;
        var htmlContent = File.ReadAllText("input.html");
        var pdf = converter.ConvertHtmlString(htmlContent);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

Imports PdfForge
Imports System.IO

Class Program
    Shared Sub Main()
        Dim converter As New HtmlToPdfConverter()
        converter.PageSize = PageSize.A4
        converter.Orientation = PageOrientation.Landscape
        Dim htmlContent As String = File.ReadAllText("input.html")
        Dim pdf As Byte() = converter.ConvertHtmlString(htmlContent)
        File.WriteAllBytes("output.pdf", pdf)
    End Sub
End Class

Después (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        var htmlContent = System.IO.File.ReadAllText("input.html");
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        var htmlContent = System.IO.File.ReadAllText("input.html");
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf
Imports IronPdf.Rendering

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape
        Dim htmlContent = System.IO.File.ReadAllText("input.html")
        Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
        pdf.SaveAs("output.pdf")
    End Sub
End Class

Este ejemplo muestra la diferencia de patrón de configuración. pdforgeestablece propiedades directamente en el objeto convertidor (converter.PageSize = PageSize.A4, converter.Orientation = PageOrientation.Landscape).

IronPDF utiliza la propiedad RenderingOptions con enumeraciones fuertemente tipadas: renderer.RenderingOptions.PaperSize = PdfPaperSize.A4 y renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape. Esto proporciona compatibilidad con IntelliSense y seguridad de tipos en tiempo de compilación. Tenga en cuenta queIronPDFrequiere importar el espacio de nombres IronPdf.Rendering para las enumeraciones de tamaño y orientación del papel. Consulte los tutoriales para ver más ejemplos de configuración.

Cambio de tipo de retorno

pdforge devuelve byte[];IronPDFdevuelve PdfDocument:

// pdforge: Returns byte[]
byte[] pdfBytes = converter.ConvertHtmlString(html);
File.WriteAllBytes("output.pdf", pdfBytes);

// IronPDF: Returns PdfDocument
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");           // Direct save
byte[] bytes = pdf.BinaryData;      // Get bytes if needed

// pdforge: Returns byte[]
byte[] pdfBytes = converter.ConvertHtmlString(html);
File.WriteAllBytes("output.pdf", pdfBytes);

// IronPDF: Returns PdfDocument
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");           // Direct save
byte[] bytes = pdf.BinaryData;      // Get bytes if needed

' pdforge: Returns byte()
Dim pdfBytes As Byte() = converter.ConvertHtmlString(html)
File.WriteAllBytes("output.pdf", pdfBytes)

' IronPDF: Returns PdfDocument
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")           ' Direct save
Dim bytes As Byte() = pdf.BinaryData ' Get bytes if needed

Cambio de clase de conversor

// pdforge: HtmlToPdfConverter
var converter = new HtmlToPdfConverter();

// IronPDF: ChromePdfRenderer
var renderer = new ChromePdfRenderer();

// pdforge: HtmlToPdfConverter
var converter = new HtmlToPdfConverter();

// IronPDF: ChromePdfRenderer
var renderer = new ChromePdfRenderer();

' pdforge: HtmlToPdfConverter
Dim converter As New HtmlToPdfConverter()

' IronPDF: ChromePdfRenderer
Dim renderer As New ChromePdfRenderer()

Cambios en los nombres de los métodos

// pdforgemethods
converter.ConvertHtmlString(html)
converter.ConvertUrl(url)

//IronPDFmethods
renderer.RenderHtmlAsPdf(html)
renderer.RenderUrlAsPdf(url)

// pdforgemethods
converter.ConvertHtmlString(html)
converter.ConvertUrl(url)

//IronPDFmethods
renderer.RenderHtmlAsPdf(html)
renderer.RenderUrlAsPdf(url)

' pdforgemethods
converter.ConvertHtmlString(html)
converter.ConvertUrl(url)

' IronPDFmethods
renderer.RenderHtmlAsPdf(html)
renderer.RenderUrlAsPdf(url)

Cambio de método de guardado

// pdforge: Manual file write
File.WriteAllBytes("output.pdf", pdfBytes);

// IronPDF: Built-in save method
pdf.SaveAs("output.pdf");

// pdforge: Manual file write
File.WriteAllBytes("output.pdf", pdfBytes);

// IronPDF: Built-in save method
pdf.SaveAs("output.pdf");

' pdforge: Manual file write
File.WriteAllBytes("output.pdf", pdfBytes)

' IronPDF: Built-in save method
pdf.SaveAs("output.pdf")

Cambio de ubicación de la configuración

pdforge utiliza propiedades del conversor;IronPDFutiliza RenderingOptions:

// pdforge: Properties on converter
converter.PageSize = PageSize.A4;
converter.Orientation = PageOrientation.Landscape;

// IronPDF: Properties on RenderingOptions
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;

// pdforge: Properties on converter
converter.PageSize = PageSize.A4;
converter.Orientation = PageOrientation.Landscape;

// IronPDF: Properties on RenderingOptions
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;

' pdforge: Properties on converter
converter.PageSize = PageSize.A4
converter.Orientation = PageOrientation.Landscape

' IronPDF: Properties on RenderingOptions
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape

Sintaxis del marcador de posición de encabezado/pie

Si utiliza números de página en encabezados o pies de página, la sintaxis del marcador de posición es diferente:

// pdforgeplaceholders
"Page {page} of {totalPages}"

//IronPDFplaceholders
"Page {page} of {total-pages}"  // Note: hyphen in total-pages

// pdforgeplaceholders
"Page {page} of {totalPages}"

//IronPDFplaceholders
"Page {page} of {total-pages}"  // Note: hyphen in total-pages

' pdforgeplaceholders
"Page {page} of {totalPages}"

' IronPDFplaceholders
"Page {page} of {total-pages}"  ' Note: hyphen in total-pages

Fusión de PDF

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");

Dim pdf1 = PdfDocument.FromFile("document1.pdf")
Dim pdf2 = PdfDocument.FromFile("document2.pdf")
Dim merged = PdfDocument.Merge(pdf1, pdf2)
merged.SaveAs("merged.pdf")

Extracción de texto

var pdf = PdfDocument.FromFile("document.pdf");
string allText = pdf.ExtractAllText();

var pdf = PdfDocument.FromFile("document.pdf");
string allText = pdf.ExtractAllText();

Dim pdf = PdfDocument.FromFile("document.pdf")
Dim allText As String = pdf.ExtractAllText()

Marcas de agua

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");

pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>")

Protección con contraseña

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";

pdf.SecuritySettings.UserPassword = "userpassword"
pdf.SecuritySettings.OwnerPassword = "ownerpassword"

Pre-Migración

• Inventariar todas las llamadas API de pdforgeen el código base
• Documente las opciones de configuración actuales utilizadas (tamaño de página, orientación)
• Identificar los marcadores de posición de encabezado/pie de página para actualizar ({totalPages} → {total-pages})
• Planifique el almacenamiento de la clave de licencia deIronPDF(se recomiendan variables de entorno)
• Pruebe primero con la licencia de prueba de IronPDF

Cambios en el paquete

• Eliminar el paquete NuGet pdforge
• Eliminar el paquete NuGet PdfForge
• Instalar IronPdf el paquete NuGet : dotnet add package IronPdf

Cambios de código

• Actualizar todas las importaciones de espacios de nombres (using PdfForge; → using IronPdf;)
• Agregar using IronPdf.Rendering; para enumeraciones de tamaño y orientación del papel
• Reemplace HtmlToPdfConverter con ChromePdfRenderer
• Reemplace ConvertHtmlString() con RenderHtmlAsPdf()
• Reemplace ConvertUrl() con RenderUrlAsPdf()
• Reemplace File.WriteAllBytes() con pdf.SaveAs()
• Mover la propiedad PageSize a RenderingOptions.PaperSize
• Mover la propiedad Orientation a RenderingOptions.PaperOrientation
• Actualizar nombres de enumeración (PageSize.A4 → PdfPaperSize.A4)
• Actualizar nombres de enumeración (PageOrientation.Landscape → PdfPaperOrientation.Landscape)
• Actualizar la sintaxis de los marcadores de posición en encabezados y pies de página

Posmigración

• Comprobar que la calidad del PDF se ajusta a las expectativas
• Verificar que la operación fuera de línea funcione
• Eliminar las credenciales de API de la configuración
• Agregue nuevas capacidades (fusión, marcas de agua, seguridad) según sea necesario