Saltar al pie de página
GUíAS DE MIGRACIóN

Cómo migrar de GemBox PDF a IronPDF en C#

Migrar de GemBox PDFa IronPDF: Guía completa de migración a C

La migración de GemBox PDFaIronPDFtransforma su flujo de trabajo PDF .NET de una construcción de documentos programática basada en coordenadas a una representación moderna basada en HTML/CSS. Esta guía proporciona una ruta de migración completa y paso a paso que elimina los límites de párrafos y simplifica la creación de documentos para desarrolladores .NET profesionales.

Por qué migrar de GemBox PDFa IronPDF

Los retos de GemBox PDF

GemBox PDF es un componente PDF .NET capaz, pero tiene limitaciones significativas que afectan al desarrollo en el mundo real:

  1. Límite de 20 párrafos en la versión gratuita: La versión gratuita te limita a 20 párrafos, y las celdas de tabla cuentan para este límite. Una simple tabla de 10 filas y 5 columnas utiliza 50 "párrafos", lo que hace que la versión gratuita sea inutilizable incluso para documentos empresariales básicos.

  2. Sin conversión de HTML a PDF: GemBox PDFrequiere la construcción programática de documentos. Hay que calcular las coordenadas y posicionar manualmente cada elemento, no hay una simple función de "renderizar este HTML".

  3. Diseño basado en coordenadas: A diferencia de HTML/CSS, donde la maquetación fluye de forma natural, GemBox PDFrequiere calcular las posiciones X/Y exactas de cada elemento de texto, imagen y forma.

  4. Conjunto de características limitado: En comparación con las bibliotecas PDF completas, GemBox PDFse centra en las operaciones básicas -leer, escribir, combinar, dividir- sin funciones avanzadas como el renderizado HTML o la compatibilidad con CSS modernas.

  5. Sólo programática: Todo cambio de diseño requiere cambios en el código. ¿Quieres ajustar el espaciado? Recalcular coordenadas. ¿Desea un tamaño de fuente diferente? Ajusta todas las posiciones Y debajo.

  6. Cuento de celdas de tabla: El límite de párrafos cuenta las celdas de la tabla, no solo los párrafos visibles. Esto hace que la versión gratuita sea prácticamente inútil para documentos con tablas.

  7. Curva de aprendizaje para el diseño: Los desarrolladores deben pensar en coordenadas en lugar de en el flujo del documento, lo que hace que tareas sencillas como "añadir un párrafo" sean sorprendentemente complejas.

Comparación entre GemBox PDFe IronPDF

AspectoGemBox PDFIronPDF
Límites de la versión gratuita20 párrafos (incluye celdas de tabla)Sólo marca de agua, sin límites de contenido
HTML a PDFNo soportadoMotor Chromium completo
Método de maquetaciónManual basado en coordenadasDiseño de flujo HTML/CSS
TablasCuenta para el límite de párrafosUso ilimitado de tablas HTML
CSS modernoNo procedeFlexbox, Grid, animaciones CSS3
Soporte de JavaScriptNo procedeEjecución completa de JavaScript
Cambios de diseñoRecalcular coordenadasEditar HTML/CSS
Curva de aprendizajeSistema de coordenadas PDFHTML/CSS (web familiar)

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 que aprovecha las tecnologías web conocidas para la generación de PDF.


Evaluación de la complejidad de la migración

Esfuerzo estimado por función

CaracterísticaComplejidad de la migraciónNotas
Cargar/guardar PDFMuy bajoAsignación directa de métodos
Fusionar PDFMuy bajoAsignación directa de métodos
Dividir PDFBajoManejo del índice de páginas
Extracción de TextoMuy bajoAsignación directa de métodos
Añadir textoMedioCoordinate → HTML
TablasBajoManual → Tablas HTML
ImágenesBajoCoordinate → HTML
Marcas de aguaBajoDiferentes API
Protección por contraseñaMedioEstructura diferente
Campos de formularioMedioDiferencias entre API

Cambio de paradigma

El mayor cambio en esta migración de GemBox PDFes el paso de maquetación basada en coordenadas a maquetación HTML/CSS:

using IronPdf; GemBox PDF: "Dibujar texto en la posición (100, 700)" IronPDF: "Renderiza este HTML con estilos CSS" using IronPdf;

Este cambio de paradigma es generalmente más fácil para los desarrolladores familiarizados con las tecnologías web, pero requiere pensar en los PDF de forma diferente.


Antes de empezar

Prerrequisitos

  1. .NET Version:IronPDFes compatible con .NET Framework 4.6.2+ y .NET Core 2.0+ / .NET 5/6/7/8/9+
  2. Clave de licencia: Obtenga su clave de licencia deIronPDFen ironpdf.com
  3. Backup: Crear una rama para el trabajo de migración
  4. Conocimientos de HTML/CSS: conocimientos básicos útiles, pero no obligatorios

Identifique todos los usos de GemBox PDF

using IronPdf;bash

Find all GemBox PDFreferences

grep -r "GemBox.Pdf|PdfDocument|PdfPage|PdfFormattedText|ComponentInfo.SetLicense" --include="*.cs" .

Find package references

grep -r "GemBox.Pdf" --include="*.csproj" . using IronPdf;

Cambios en el paquete NuGet

using IronPdf;bash

Remove GemBox PDF

dotnet remove package GemBox.Pdf

Install IronPDF

dotnet add package IronPdf using IronPdf;


Inicio rápido de la migración

Paso 1: Actualizar la configuración de la licencia

Antes (GemBox PDF):

using IronPdf;csharp // Must call before any GemBox PDFoperations ComponentInfo.SetLicense("FREE-LIMITED-KEY"); // Or for professional: ComponentInfo.SetLicense("YOUR-PROFESSIONAL-LICENSE"); using IronPdf;

Después (IronPDF):

using IronPdf;csharp // Set once at application startup IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";

// Or in appsettings.json: // { "IronPdf.License.LicenseKey": "YOUR-LICENSE-KEY" } using IronPdf;

Paso 2: Actualizar las importaciones de espacios de nombres

using IronPdf;csharp // Before (GemBox PDF) using GemBox.Pdf; using GemBox.Pdf.Content;

// After (IronPDF) using IronPdf; using IronPdf.Editing; using IronPdf;

Paso 3: Patrón básico de conversión

Antes (GemBox PDF):

using IronPdf;csharp using GemBox.Pdf; using GemBox.Pdf.Content;

ComponentInfo.SetLicense("FREE-LIMITED-KEY");

using (var document = new PdfDocument()) { var page = document.Pages.Add(); var formattedText = new PdfFormattedText() { Text = "Hello World", FontSize = 24 };

page.Content.DrawText(formattedText, new PdfPoint(100, 700));
document.Save("output.pdf");

} using IronPdf;

Después (IronPDF):

using IronPdf;csharp using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

var renderer = new ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf("

Hello World

"); pdf.SaveAs("output.pdf"); using IronPdf;

Diferencias Clave:

  • No se necesitan cálculos de coordenadas
  • HTML/CSS en lugar de diseño programático
  • Sin límite de párrafos
  • Código más sencillo y legible

Referencia completa de la API

Mapeo de espacios de nombres

GemBox PDFIronPDF
GemBox.Pdf<código>IronPDF</código
<código>GemBox.Pdf.Content</código<código>IronPDF</código(el contenido es HTML)
<código>GemBox.Pdf.Seguridad</código<código>IronPDF</código(Ajustes de seguridad)
<código>GemBox.Pdf.Forms</código<código>IronPdf.Forms</código

Mapeo de clases principales

GemBox PDFIronPDFDescripción
Documento PDFDocumento PDFClase de documento PDF principal
Página PDF<código>PdfDocument.Pages[i]</código>Representación de la página
<código>ContenidoPdf</códigoN/A (usar HTML)Contenido de la página
<código>Texto con formato PDF</códigoN/A (usar HTML)Texto con formato
PdfPointN/A (utilizar posicionamiento CSS)Posición de las coordenadas
<código>ComponentInfo.SetLicense()</código<código>IronPdf.License.LicenseKey</código>Gestión de licencias

Operaciones de documentos

GemBox PDFIronPDFNotas
nuevo PdfDocument()nuevo PdfDocument()Crear nuevo documento
<código>PdfDocument.Load(ruta)</código<código>PdfDocument.FromFile(path)</códigoCargar desde archivo
<código>PdfDocument.Load(stream)</código<código>PdfDocument.FromStream(stream)</códigoCargar desde stream
<código>document.Save(ruta)</código<código>pdf.SaveAs(ruta)</códigoGuardar en archivo
<código>document.Save(stream)</códigopdf.Stream o pdf.BinaryDataObtener como flujo/bytes

Operaciones de página

GemBox PDFIronPDFNotas
document.Pages.Add()Creación mediante renderización HTMLAñadir nueva página
document.Pages.Count<código>pdf.PageCount</códigoNúmero de páginas
document.Pages[index]pdf.Pages[index]Página de acceso (ambas con índice 0)
<código>document.Pages.AddClone(pages)</códigoPdfDocument.Merge()Páginas clonar/fusionar

Operaciones de texto y contenido

GemBox PDFIronPDFNotas
<código>new PdfFormattedText()</códigoCadena HTMLContenido del texto
<código>formattedText.FontSize = 12</códigoCSS tamaño de fuente: 12ptTamaño de letra
formattedText.Font = ...CSS family: ...Familia de fuentes
<código>page.Content.DrawText(text, point)</códigorenderer.RenderHtmlAsPdf(html)Renderizar texto
<código>page.Content.GetText()</código><código>pdf.ExtractTextFromPage(i)</códigoExtraer texto

Ejemplos de migración de código

Ejemplo 1: Conversión de HTML a PDF

Antes (GemBox PDF):

using IronPdf;csharp // NuGet: Install-Package GemBox.Pdf using GemBox.Pdf; using GemBox.Pdf.Content;

class Program { static void Main() { ComponentInfo.SetLicense("FREE-LIMITED-KEY");

    var document = PdfDocument.Load("input.html");
    document.Save("output.pdf");
}

} using IronPdf;

Después (IronPDF):

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

class Program { static void Main() { var renderer = new ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf("

Hello World

"); pdf.SaveAs("output.pdf"); } } using IronPdf;

El ChromePdfRenderer deIronPDFutiliza un moderno motor Chromium para una renderización precisa de HTML/CSS/JavaScript. A diferencia del soporte limitado de HTML de GemBox PDF,IronPDFpuede renderizar cualquier contenido HTML con soporte completo de CSS3 y JavaScript. Consulte la documentación HTML a PDF para obtener más opciones de conversión.

Ejemplo 2: Combinar archivos PDF

Antes (GemBox PDF):

using IronPdf;csharp // NuGet: Install-Package GemBox.Pdf using GemBox.Pdf; using System.Linq;

class Program { static void Main() { ComponentInfo.SetLicense("FREE-LIMITED-KEY");

    using (var document = new PdfDocument())
    {
        var source1 = PdfDocument.Load("document1.pdf");
        var source2 = PdfDocument.Load("document2.pdf");

        document.Pages.AddClone(source1.Pages);
        document.Pages.AddClone(source2.Pages);

        document.Save("merged.pdf");
    }
}

} using IronPdf;

Después (IronPDF):

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

class Program { static void Main() { var pdf1 = PdfDocument.FromFile("document1.pdf"); var pdf2 = PdfDocument.FromFile("document2.pdf");

    var merged = PdfDocument.Merge(pdf1, pdf2);
    merged.SaveAs("merged.pdf");
}

} using IronPdf;

El método estático Merge deIronPDFsimplifica la operación: no es necesario crear un documento vacío y clonar las páginas individualmente. Más información sobre mezclar y dividir archivos PDF.

Ejemplo 3: Añadir texto a un PDF

Antes (GemBox PDF):

using IronPdf;csharp // NuGet: Install-Package GemBox.Pdf using GemBox.Pdf; using GemBox.Pdf.Content;

class Program { static void Main() { ComponentInfo.SetLicense("FREE-LIMITED-KEY");

    using (var document = new PdfDocument())
    {
        var page = document.Pages.Add();
        var formattedText = new PdfFormattedText()
        {
            Text = "Hello World",
            FontSize = 24
        };

        page.Content.DrawText(formattedText, new PdfPoint(100, 700));
        document.Save("output.pdf");
    }
}

} using IronPdf;

Después (IronPDF):

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

class Program { static void Main() { var renderer = new ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf("

Original Content

");

    var stamper = new TextStamper()
    {
        Text = "Hello World",
        FontSize = 24,
        HorizontalOffset = 100,
        VerticalOffset = 700
    };

    pdf.ApplyStamp(stamper);
    pdf.SaveAs("output.pdf");
}

} using IronPdf;

Para añadir texto a los PDF existentes,IronPDFproporciona la clase TextStamper, que ofrece un control preciso del posicionamiento. Para documentos nuevos, basta con incluir el texto en la plantilla HTML. Consulte la documentación de sellado para obtener opciones adicionales.

Ejemplo 4: Creación de tablas (¡la mayor mejora!)

Antes (GemBox PDF) - Cada celda cuenta para el límite de 20 párrafos:

using IronPdf;csharp using GemBox.Pdf; using GemBox.Pdf.Content;

ComponentInfo.SetLicense("FREE-LIMITED-KEY");

using (var document = new PdfDocument()) { var page = document.Pages.Add(); double y = 700; double[] xPositions = { 50, 200, 300, 400 };

// Headers (4 paragraphs)
var headers = new[] { "Product", "Price", "Qty", "Total" };
for (int i = 0; i < headers.Length; i++)
{
    var text = new PdfFormattedText { Text = headers[i], FontSize = 12 };
    page.Content.DrawText(text, new PdfPoint(xPositions[i], y));
}
y -= 20;

// Data rows (4 paragraphs per row!)
// Can only add a few rows before hitting 20-paragraph limit!

document.Save("products.pdf");

} using IronPdf;

Después (IronPDF) - Sin límites, tablas HTML adecuadas:

using IronPdf;csharp using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

var html = @"

ProductPriceQtyTotal
Widget A$19.995$99.95
Widget B$29.993$89.97
"; var renderer = new ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf(html); pdf.SaveAs("products.pdf"); using IronPdf; Esta es la mejora más significativa en la migración de GemBox PDF. Las tablas que eran imposibles en la versión gratuita de GemBox PDFfuncionan a la perfección enIronPDFcon soporte completo de estilos CSS. --- ## Notas de migración críticas ### Posicionamiento de coordenadas a CSS Si necesita un posicionamiento perfecto (similar al sistema de coordenadas de GemBox PDF), utilice el posicionamiento absoluto CSS: using IronPdf;html
Text positioned at specific coordinates
using IronPdf; ### Indexación de páginas Tanto GemBox PDFcomoIronPDFutilizan páginas con índice 0, lo que facilita este aspecto de la migración: using IronPdf;csharp // GemBox PDF var page = document.Pages[0]; // IronPDF var page = pdf.Pages[0]; using IronPdf; ### Configuración de seguridad using IronPdf;csharp // GemBox PDF document.SaveOptions.SetPasswordEncryption(userPassword, ownerPassword); // IronPDF pdf.SecuritySettings.UserPassword = "userPassword"; pdf.SecuritySettings.OwnerPassword = "ownerPassword"; using IronPdf; --- ## Solución de problemas ### Asunto 1: PdfFormattedText no encontrado **Problema**:Texto con formato PDFHello

"; var pdf = renderer.RenderHtmlAsPdf(html); using IronPdf; ### Asunto 2: Método DrawText no encontrado **Problema**: `page.Content.DrawText()` no disponible. **Solución**: Crear contenido mediante renderizado HTML o utilizar estampadores: using IronPdf;csharp // For new documents - render HTML var renderer = new ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf("

Content

"); // For existing documents - use stampers var stamper = new TextStamper() { Text = "Added Text" }; pdf.ApplyStamp(stamper); using IronPdf; ### Cuestión 3: Diferencias en la carga de documentos **Problema**: `PdfDocument.Load()` no encontrado. **Solución**: Utilice `PdfDocument.FromFile()` o `FromStream()`: using IronPdf;csharp // GemBox PDF var doc = PdfDocument.Load("input.pdf"); // IronPDF var pdf = PdfDocument.FromFile("input.pdf"); using IronPdf; ### Número 4: Diferencias en los métodos de guardado **Problema**: la firma del método `document.Save()` es diferente. **Solución**: Utilice `SaveAs()`: using IronPdf;csharp // GemBox PDF document.Save("output.pdf"); // IronPDF pdf.SaveAs("output.pdf"); using IronPdf; --- ## Lista de comprobación de la migración ### Pre-Migración - [ ] Inventario del uso de GemBox PDFen el código base - [ ] Identificar diseños basados en coordenadas que necesiten conversión a HTML - [ ] Evalúe los límites de párrafo actuales que afectan a su código - [ ] Obtener la clave de licencia de IronPDF - [ ] Crear rama de migración en el control de versiones ### Migración de código - [ ] Eliminar el paquete NuGet de GemBox PDF: `dotnet remove paquete GemBox.Pdf` - [ ] Instalar el paquete NuGet IronPdf: `dotnet add package IronPdf` - [ ] Actualizar las importaciones de espacios de nombres - [ReemplaceComponentInfo.SetLicense()Texto con formato PDF
Curtis Chau
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