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

Cómo migrar de GemBox PDF a IronPDF en 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 lo restringe a 20 párrafos, y las celdas de la 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. No hay 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 el diseño fluye naturalmente, GemBox PDFrequiere que calcules las posiciones X/Y exactas para cada elemento de texto, imagen y forma.

  4. Conjunto de funciones limitado: en comparación con las bibliotecas de PDF completas, GemBox PDFse centra en operaciones básicas (lectura, escritura, fusión, división) sin funciones avanzadas como renderizado HTML o compatibilidad con CSS moderno.

  5. Solo programático: cada 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. Conteo de celdas de tabla: El límite de párrafos cuenta las celdas de 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 de documentos, lo que hace que tareas simples como "agregar un párrafo" sean sorprendentemente complejas.

Comparación entre GemBox PDFe IronPDF

Aspecto GemBox PDF IronPDF
Límites de la versión gratuita 20 párrafos (incluye celdas de tabla) Sólo marca de agua, sin límites de contenido
HTML a PDF No soportado Motor Chromium completo
Método de maquetación Manual basado en coordenadas Diseño de flujo HTML/CSS
Tablas Cuenta para el límite de párrafos Uso ilimitado de tablas HTML
CSS moderno No procede Flexbox, Grid, animaciones CSS3
Soporte de JavaScript No procede Ejecución completa de JavaScript
Cambios de diseño Recalcular coordenadas Editar HTML/CSS
Curva de aprendizaje Sistema de coordenadas PDF HTML/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ística Complejidad de la migración Notas
Cargar/guardar PDF Muy bajo Asignación directa de métodos
Fusionar PDF Muy bajo Asignación directa de métodos
Dividir PDF Bajo Manejo del índice de páginas
Extracción de Texto Muy bajo Asignación directa de métodos
Añadir texto Medio Coordinate → HTML
Tablas Bajo Manual → Tablas HTML
Imágenes Bajo Coordinate → HTML
Marcas de agua Bajo Diferentes API
Protección por contraseña Medio Estructura diferente
Campos de formulario Medio Diferencias entre API

Cambio de paradigma

El cambio más grande en esta migración de PDF de GemBox es pasar del diseño basado en coordenadas al diseño 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. Versión .NET: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. Copia de seguridad: crear una rama para el trabajo de migración
  4. Conocimientos de HTML/CSS: Es útil tener conocimientos básicos, pero no es obligatorio.

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 PDF IronPDF
GemBox.Pdf <código>IronPDF`
<código>GemBox.Pdf.Content <código>IronPDF(el contenido es HTML)
<código>GemBox.Pdf.Seguridad <código>IronPDF(Ajustes de seguridad)
<código>GemBox.Pdf.Forms <código>IronPdf.Forms

Mapeo de clases principales

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

Operaciones de documentos

GemBox PDF IronPDF Notas
nuevo PdfDocument() nuevo PdfDocument() Crear nuevo documento
<código>PdfDocument.Load(ruta)` <código>PdfDocument.FromFile(path) Cargar desde archivo
<código>PdfDocument.Load(stream) <código>PdfDocument.FromStream(stream) Cargar desde stream
<código>document.Save(ruta) <código>pdf.SaveAs(ruta) Guardar en archivo
<código>document.Save(stream) pdf.Stream o pdf.BinaryData Obtener como flujo/bytes

Operaciones de página

GemBox PDF IronPDF Notas
document.Pages.Add() Creación mediante renderización HTML Añadir nueva página
document.Pages.Count <código>pdf.PageCount` Número de páginas
document.Pages[index] pdf.Pages[index] Página de acceso (ambas con índice 0)
<código>document.Pages.AddClone(pages)|PdfDocument.Merge()` Páginas clonar/fusionar

Operaciones de texto y contenido

GemBox PDF IronPDF Notas
<código>new PdfFormattedText()` Cadena HTML Contenido del texto
<código>formattedText.FontSize = 12 CSS tamaño de fuente: 12pt Tamaño de letra
formattedText.Font = ... CSS family: ... Familia de fuentes
<código>page.Content.DrawText(text, point)|renderer.RenderHtmlAsPdf(html)` Renderizar texto
<código>page.Content.GetText()` <código>pdf.ExtractTextFromPage(i) Extraer 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 estampado 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 = @"

Product Price Qty Total
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 PDF`no existe en IronPDF. **Solución:** utilice HTML con estilo CSS: using IronPdf;csharp // GemBox PDF var text = new PdfFormattedText { Text = "Hello", FontSize = 24 }; // IronPDF var html = "

Hello

"; var pdf = renderer.RenderHtmlAsPdf(html); using IronPdf; ### Asunto 2: Método DrawText no encontrado **Problema:** `page.Content.DrawText()` no está disponible. **Solución:** Cree contenido mediante renderizado HTML o utilice 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 - Inventariar todo el uso de PDF de GemBox en el código base - Identificar diseños basados en coordenadas que necesitan conversión HTML - Evaluar los límites de párrafo actuales que afectan 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 package GemBox.Pdf` - Instalar el paquete NuGet IronPdf: `dotnet add package IronPdf` - Actualizar las importaciones de espacios de nombres - Reemplace ComponentInfo.SetLicense()`con `IronPdf.License.LicenseKey` - Convertir `PdfDocument.Load()` a `PdfDocument.FromFile()` - Convertir `document.Save()` a `pdf.SaveAs()` - Reemplazar texto basado en coordenadas con contenido HTML - Convertir Texto con formato PDF`a HTML con estilo CSS - Actualizar las operaciones de fusión para utilizar `PdfDocument.Merge()` ### Pruebas - Verificar que todos los documentos se generen correctamente - Validar que la apariencia del documento coincida con las expectativas - Generación de tabla de prueba (anteriormente limitada por la regla de 20 párrafos) - Verificar que la extracción de texto funcione correctamente - Prueba de operaciones de fusión y división - Validar la funcionalidad de seguridad/cifrado ### Posmigración - Eliminar las claves de licencia de GemBox PDF - Actualización de la documentación - Capacitar al equipo sobre el enfoque HTML/CSS para archivos PDF - ¡Disfruta de contenido ilimitado sin límite de párrafos! ---
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