GUIAS DE MIGRAçãO

Como migrar do GemBox PDF para o IronPDF em C#

Atualizado:fevereiro 1, 2026

A migração do PDF GemBox para o IronPDF transforma seu fluxo de trabalho de PDF em .NET , passando da construção programática de documentos baseada em coordenadas para a renderização moderna baseada em HTML/CSS. Este guia fornece um caminho de migração abrangente, passo a passo, que elimina os limites de parágrafos e simplifica a criação de documentos para desenvolvedores .NET profissionais.

Por que migrar do PDF GemBox para o IronPDF?

Os Desafios do GemBox PDF

O PDF GemBox é um componente PDF .NET competente, mas possui limitações significativas que afetam o desenvolvimento em situações reais:

Limite de 20 parágrafos na versão gratuita: A versão gratuita limita o texto a 20 parágrafos, e as células da tabela contam para esse limite. Uma tabela simples com 10 linhas e 5 colunas utiliza 50 "parágrafos", tornando a versão gratuita inviável até mesmo para documentos comerciais básicos.
Sem conversão de HTML para PDF: o PDF GemBox requer a construção programática do documento. Você precisa calcular as coordenadas e posicionar manualmente cada elemento — não existe uma função simples de "renderizar este HTML".
Layout baseado em coordenadas: Ao contrário do HTML/CSS, onde o layout flui naturalmente, o PDF GemBox exige que você calcule as posições X/Y exatas para cada elemento de texto, imagem e forma.
Conjunto de recursos limitado: em comparação com bibliotecas de PDF abrangentes, o PDF GemBox concentra-se em operações básicas — leitura, escrita, mesclagem e divisão — sem recursos avançados como renderização de HTML ou suporte a CSS moderno.
Somente Programático: Cada alteração de design requer alterações de código. Deseja ajustar o espaçamento? Recalcular coordenadas. Deseja um tamanho de fonte diferente? Ajuste todas as posições Y abaixo dele.
Contagem de células de tabela: O limite de parágrafos conta as células da tabela, não apenas os parágrafos visíveis. Isso torna a versão gratuita praticamente inútil para documentos com tabelas.
Curva de Aprendizagem para Design: Os desenvolvedores precisam pensar em coordenadas em vez de fluxo de documentos, o que torna tarefas simples como "adicionar um parágrafo" surpreendentemente complexas.

Comparação entre PDF GemBox e IronPDF

Aspecto	PDF GemBox	IronPDF
Limitações da versão gratuita	20 parágrafos (incluindo células de tabela)	Apenas marca d'água, sem limites de conteúdo.
HTML para PDF	Não suportado	Motor totalmente cromado
Abordagem de layout	Manual baseado em coordenadas	Layout de fluxo HTML/CSS
Tabelas	Contabilize para o limite do parágrafo	Ilimitado, use tabelas HTML
CSS moderno	Não aplicável	Flexbox, Grid, animações CSS3
Suporte a JavaScript	Não aplicável	Execução completa de JavaScript
Alterações de design	Recalcular coordenadas	Editar HTML/CSS
Curva de Aprendizagem	Sistema de coordenadas PDF	HTML/CSS (familiarizado com a web)

Para equipes que planejam a adoção do .NET 10 e do C# 14 até 2025 e 2026, o IronPDF oferece uma base preparada para o futuro que aproveita tecnologias web já conhecidas para a geração de PDFs.

Avaliação da Complexidade da Migração

Esforço estimado por funcionalidade

Recurso	Complexidade da Migração
Carregar/Salvar PDFs	Muito baixo
Mesclar PDFs	Muito baixo
Dividir PDFs	Baixo
Extração de texto	Muito baixo
Adicionar texto	Médio
Tabelas	Baixo
Imagens	Baixo
Marcas d'água	Baixo
Proteção por senha	Médio
Campos do formulário	Médio

Mudança de paradigma

A principal mudança nesta migração para PDF do GemBox é a transição do layout baseado em coordenadas para o layout HTML/CSS:

GemBox PDF: "Desenhar texto na posição (100, 700)"
IronPDF: "Renderize este HTML com estilo CSS"

Essa mudança de paradigma geralmente é mais fácil para desenvolvedores familiarizados com tecnologias web, mas exige uma forma diferente de pensar sobre os PDFs.

Antes de começar

Pré-requisitos

Versão do .NET : O IronPDF é compatível com o .NET Framework 4.6.2+ e .NET Core 2.0+ / .NET 5/6/7/8/9+
Chave de licença: Obtenha sua chave de licença do IronPDF em IronPDF
Backup: Crie uma ramificação para o trabalho de migração.
Conhecimento de HTML/CSS: Familiaridade básica é útil, mas não obrigatória.

Identificar todos os usos do GemBox PDF

# Find all PDF GemBox references
grep -r "GemBox\.Pdf\|PdfDocument\|PdfPage\|PdfFormattedText\|ComponentInfo\.SetLicense" --include="*.cs" .

# Find package references
grep -r "GemBox\.Pdf" --include="*.csproj" .

# Find all PDF GemBox references
grep -r "GemBox\.Pdf\|PdfDocument\|PdfPage\|PdfFormattedText\|ComponentInfo\.SetLicense" --include="*.cs" .

# Find package references
grep -r "GemBox\.Pdf" --include="*.csproj" .

SHELL

Alterações no pacote NuGet

# Remove GemBox PDF
dotnet remove package GemBox.Pdf

# Install IronPDF
dotnet add package IronPdf

# Remove GemBox PDF
dotnet remove package GemBox.Pdf

# Install IronPDF
dotnet add package IronPdf

SHELL

Migração de Início Rápido

Etapa 1: Atualizar a configuração da licença

Antes (PDF da GemBox):

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

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

' Must call before any PDF GemBox operations
ComponentInfo.SetLicense("FREE-LIMITED-KEY")
' Or for professional:
ComponentInfo.SetLicense("YOUR-PROFESSIONAL-LICENSE")

$vbLabelText $csharpLabel

Após (IronPDF):

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

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

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

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

' Set once at application startup
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"

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

$vbLabelText $csharpLabel

Etapa 2: Atualizar importações de namespace

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

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

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

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

Imports IronPdf
Imports IronPdf.Editing

$vbLabelText $csharpLabel

Etapa 3: Padrão de Conversão Básico

Antes (PDF da GemBox):

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 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");
}

Imports GemBox.Pdf
Imports GemBox.Pdf.Content

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

Using document As New PdfDocument()
    Dim page = document.Pages.Add()
    Dim formattedText As New PdfFormattedText() With {
        .Text = "Hello World",
        .FontSize = 24
    }

    page.Content.DrawText(formattedText, New PdfPoint(100, 700))
    document.Save("output.pdf")
End Using

$vbLabelText $csharpLabel

Após (IronPDF):

using IronPdf;

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

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1 style='font-size:24px;'>Hello World</h1>");
pdf.SaveAs("output.pdf");

using IronPdf;

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

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1 style='font-size:24px;'>Hello World</h1>");
pdf.SaveAs("output.pdf");

Imports IronPdf

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

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1 style='font-size:24px;'>Hello World</h1>")
pdf.SaveAs("output.pdf")

$vbLabelText $csharpLabel

Principais diferenças:

Não são necessários cálculos de coordenadas
HTML/CSS em vez de layout programático
Sem limite de parágrafos
Código mais simples e legível

Referência completa da API

Mapeamento de Namespace

PDF GemBox	IronPDF
`GemBox.Pdf`	`IronPdf`
`GemBox.Pdf.Content`	`IronPdf` (conteúdo em HTML)
`GemBox.Pdf.Security`	`IronPdf` (Configurações de segurança)
`GemBox.Pdf.Forms`	`IronPdf.Forms`

Mapeamento de Classes Principais

PDF GemBox	IronPDF	Descrição
`PdfDocument`	`PdfDocument`	Classe principal de documentos PDF
`PdfPage`	`PdfDocument.Pages[i]`	Representação da página
`PdfContent`	Não aplicável (use HTML)	Conteúdo da página
`PdfFormattedText`	Não aplicável (use HTML)	Texto formatado
`PdfPoint`	Não aplicável (usar posicionamento CSS)	Posicionamento por coordenadas
`ComponentInfo.SetLicense()`	`IronPdf.License.LicenseKey`	Gestão de licenças

Operações de Documentos

PDF GemBox	IronPDF
`new PdfDocument()`	`new PdfDocument()`
`PdfDocument.Load(path)`	`PdfDocument.FromFile(path)`
`PdfDocument.Load(stream)`	`PdfDocument.FromStream(stream)`
`document.Save(path)`	`pdf.SaveAs(path)`
`document.Save(stream)`	`pdf.Stream` ou `pdf.BinaryData`

Operações de página

PDF GemBox	IronPDF
`document.Pages.Add()`	Criar através da renderização HTML
`document.Pages.Count`	`pdf.PageCount`
`document.Pages[index]`	`pdf.Pages[index]`
`document.Pages.AddClone(pages)`	`PdfDocument.Merge()`

Operações de texto e conteúdo

PDF GemBox	IronPDF
`new PdfFormattedText()`	string HTML
`formattedText.FontSize = 12`	CSS `font-size: 12pt`
`formattedText.Font = ...`	CSS `font-family: ...`
`page.Content.DrawText(text, point)`	`renderer.RenderHtmlAsPdf(html)`
`page.Content.GetText()`	`pdf.ExtractTextFromPage(i)`

Exemplos de migração de código

Exemplo 1: Conversão de HTML para PDF

Antes (PDF da GemBox):

// 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");
    }
}

// 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");
    }
}

Imports GemBox.Pdf
Imports GemBox.Pdf.Content

Module Program
    Sub Main()
        ComponentInfo.SetLicense("FREE-LIMITED-KEY")

        Dim document = PdfDocument.Load("input.html")
        document.Save("output.pdf")
    End Sub
End Module

$vbLabelText $csharpLabel

Após (IronPDF):

// NuGet: Install-Package IronPdf
using IronPdf;

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

// NuGet: Install-Package IronPdf
using IronPdf;

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

Imports IronPdf

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

$vbLabelText $csharpLabel

O ChromePdfRenderer do IronPDF usa um mecanismo Chromium moderno para renderização precisa de HTML/CSS/ JavaScript . Ao contrário do suporte limitado a HTML do GemBox PDF, o IronPDF pode renderizar qualquer conteúdo HTML com suporte completo a CSS3 e JavaScript . Consulte a documentação de conversão de HTML para PDF para obter mais opções de renderização.

Exemplo 2: Mesclar arquivos PDF

Antes (PDF da GemBox):

// 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");
        }
    }
}

// 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");
        }
    }
}

Imports GemBox.Pdf
Imports System.Linq

Module Program
    Sub Main()
        ComponentInfo.SetLicense("FREE-LIMITED-KEY")

        Using document As New PdfDocument()
            Dim source1 = PdfDocument.Load("document1.pdf")
            Dim source2 = PdfDocument.Load("document2.pdf")

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

            document.Save("merged.pdf")
        End Using
    End Sub
End Module

$vbLabelText $csharpLabel

Após (IronPDF):

// 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");
    }
}

// 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");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim pdf1 = PdfDocument.FromFile("document1.pdf")
        Dim pdf2 = PdfDocument.FromFile("document2.pdf")

        Dim merged = PdfDocument.Merge(pdf1, pdf2)
        merged.SaveAs("merged.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

O método estático Merge do IronPDF simplifica a operação — não há necessidade de criar um documento vazio e clonar páginas individualmente. Saiba mais sobre como mesclar e dividir PDFs .

Exemplo 3: Adicionar texto a um PDF

Antes (PDF da GemBox):

// 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");
        }
    }
}

// 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");
        }
    }
}

Imports GemBox.Pdf
Imports GemBox.Pdf.Content

Module Program

    Sub Main()
        ComponentInfo.SetLicense("FREE-LIMITED-KEY")

        Using document As New PdfDocument()
            Dim page = document.Pages.Add()
            Dim formattedText As New PdfFormattedText() With {
                .Text = "Hello World",
                .FontSize = 24
            }

            page.Content.DrawText(formattedText, New PdfPoint(100, 700))
            document.Save("output.pdf")
        End Using
    End Sub

End Module

$vbLabelText $csharpLabel

Após (IronPDF):

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<p>Original Content</p>");

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

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

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<p>Original Content</p>");

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

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

Imports IronPdf
Imports IronPdf.Editing

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<p>Original Content</p>")

        Dim stamper = New TextStamper() With {
            .Text = "Hello World",
            .FontSize = 24,
            .HorizontalOffset = 100,
            .VerticalOffset = 700
        }

        pdf.ApplyStamp(stamper)
        pdf.SaveAs("output.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

Para adicionar texto a PDFs existentes, o IronPDF fornece a classe TextStamper, que oferece controle preciso de posicionamento. Para novos documentos, basta incluir o texto no seu modelo HTML. Consulte a documentação de estampagem para opções adicionais.

Exemplo 4: Criando tabelas (A maior melhoria!)

Antes (PDF do GemBox) - Cada célula conta para o limite de 20 parágrafos:

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 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");
}

Imports GemBox.Pdf
Imports GemBox.Pdf.Content

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

Using document As New PdfDocument()
    Dim page = document.Pages.Add()
    Dim y As Double = 700
    Dim xPositions As Double() = {50, 200, 300, 400}

    ' Headers (4 paragraphs)
    Dim headers = {"Product", "Price", "Qty", "Total"}
    For i As Integer = 0 To headers.Length - 1
        Dim text As New PdfFormattedText With {.Text = headers(i), .FontSize = 12}
        page.Content.DrawText(text, New PdfPoint(xPositions(i), y))
    Next
    y -= 20

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

    document.Save("products.pdf")
End Using

$vbLabelText $csharpLabel

Após (IronPDF) - Sem limites, tabelas HTML adequadas:

using IronPdf;

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

var html = @"
    <html>
    <head>
        <style>
            table { border-collapse: collapse; width: 100%; }
            th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
            th { background-color: #4CAF50; color: white; }
            tr:nth-child(even) { background-color: #f2f2f2; }
        </style>
    </head>
    <body>
        <table>
            <thead>
                <tr>
                    <th>Product</th>
                    <th>Price</th>
                    <th>Qty</th>
                    <th>Total</th>
                </tr>
            </thead>
            <tbody>
                <tr><td>Widget A</td><td>$19.99</td><td>5</td><td>$99.95</td></tr>
                <tr><td>Widget B</td><td>$29.99</td><td>3</td><td>$89.97</td></tr>

            </tbody>
        </table>
    </body>
    </html>";

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

using IronPdf;

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

var html = @"
    <html>
    <head>
        <style>
            table { border-collapse: collapse; width: 100%; }
            th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
            th { background-color: #4CAF50; color: white; }
            tr:nth-child(even) { background-color: #f2f2f2; }
        </style>
    </head>
    <body>
        <table>
            <thead>
                <tr>
                    <th>Product</th>
                    <th>Price</th>
                    <th>Qty</th>
                    <th>Total</th>
                </tr>
            </thead>
            <tbody>
                <tr><td>Widget A</td><td>$19.99</td><td>5</td><td>$99.95</td></tr>
                <tr><td>Widget B</td><td>$29.99</td><td>3</td><td>$89.97</td></tr>

            </tbody>
        </table>
    </body>
    </html>";

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

Imports IronPdf

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

Dim html As String = "
    <html>
    <head>
        <style>
            table { border-collapse: collapse; width: 100%; }
            th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
            th { background-color: #4CAF50; color: white; }
            tr:nth-child(even) { background-color: #f2f2f2; }
        </style>
    </head>
    <body>
        <table>
            <thead>
                <tr>
                    <th>Product</th>
                    <th>Price</th>
                    <th>Qty</th>
                    <th>Total</th>
                </tr>
            </thead>
            <tbody>
                <tr><td>Widget A</td><td>$19.99</td><td>5</td><td>$99.95</td></tr>
                <tr><td>Widget B</td><td>$29.99</td><td>3</td><td>$89.97</td></tr>

            </tbody>
        </table>
    </body>
    </html>"

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("products.pdf")

$vbLabelText $csharpLabel

Essa é a melhoria mais significativa na migração de PDFs do GemBox. Tabelas que eram impossíveis na versão gratuita do PDF GemBox funcionam perfeitamente no IronPDF , com suporte completo a estilos CSS.

Notas críticas sobre migração

Coordenadas para posicionamento CSS

Se você precisa de posicionamento com precisão de pixel (semelhante ao sistema de coordenadas do GemBox PDF), use o posicionamento absoluto em CSS:

<div style="position:absolute; left:50px; top:750px; font-size:24px;">
    Text positioned at specific coordinates
</div>

<div style="position:absolute; left:50px; top:750px; font-size:24px;">
    Text positioned at specific coordinates
</div>

HTML

Indexação de páginas

Tanto o PDF GemBox quanto o IronPDF usam páginas com índice 0, o que torna esse aspecto da migração simples:

// GemBox PDF
var page = document.Pages[0];

// IronPDF
var page = pdf.Pages[0];

// GemBox PDF
var page = document.Pages[0];

// IronPDF
var page = pdf.Pages[0];

' GemBox PDF
Dim page = document.Pages(0)

' IronPDF
Dim page = pdf.Pages(0)

$vbLabelText $csharpLabel

Configurações de segurança

// GemBox PDF
document.SaveOptions.SetPasswordEncryption(userPassword, ownerPassword);

// IronPDF
pdf.SecuritySettings.UserPassword = "userPassword";
pdf.SecuritySettings.OwnerPassword = "ownerPassword";

// GemBox PDF
document.SaveOptions.SetPasswordEncryption(userPassword, ownerPassword);

// IronPDF
pdf.SecuritySettings.UserPassword = "userPassword";
pdf.SecuritySettings.OwnerPassword = "ownerPassword";

' GemBox PDF
document.SaveOptions.SetPasswordEncryption(userPassword, ownerPassword)

' IronPDF
pdf.SecuritySettings.UserPassword = "userPassword"
pdf.SecuritySettings.OwnerPassword = "ownerPassword"

$vbLabelText $csharpLabel

Solução de problemas

Problema 1: Texto formatado em PDF não encontrado

Problema: PdfFormattedText não existe no IronPDF.

Solução: Utilize HTML com estilização CSS:

// GemBox PDF
var text = new PdfFormattedText { Text = "Hello", FontSize = 24 };

// IronPDF
var html = "<p style='font-size:24px;'>Hello</p>";
var pdf = renderer.RenderHtmlAsPdf(html);

// GemBox PDF
var text = new PdfFormattedText { Text = "Hello", FontSize = 24 };

// IronPDF
var html = "<p style='font-size:24px;'>Hello</p>";
var pdf = renderer.RenderHtmlAsPdf(html);

' GemBox PDF
Dim text As New PdfFormattedText With {.Text = "Hello", .FontSize = 24}

' IronPDF
Dim html As String = "<p style='font-size:24px;'>Hello</p>"
Dim pdf = renderer.RenderHtmlAsPdf(html)

$vbLabelText $csharpLabel

Problema 2: Método DrawText não encontrado

Problema: page.Content.DrawText() não disponível.

Solução: Crie conteúdo por meio de renderização HTML ou use carimbos:

// For new documents - render HTML
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Content</h1>");

// For existing documents - use stampers
var stamper = new TextStamper() { Text = "Added Text" };
pdf.ApplyStamp(stamper);

// For new documents - render HTML
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Content</h1>");

// For existing documents - use stampers
var stamper = new TextStamper() { Text = "Added Text" };
pdf.ApplyStamp(stamper);

Imports System

' For new documents - render HTML
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Content</h1>")

' For existing documents - use stampers
Dim stamper As New TextStamper() With {.Text = "Added Text"}
pdf.ApplyStamp(stamper)

$vbLabelText $csharpLabel

Problema 3: Diferenças no carregamento de documentos

Problema: PdfDocument.Load() não encontrado.

Solução: Use PdfDocument.FromFile() ou FromStream():

// GemBox PDF
var doc = PdfDocument.Load("input.pdf");

// IronPDF
var pdf = PdfDocument.FromFile("input.pdf");

// GemBox PDF
var doc = PdfDocument.Load("input.pdf");

// IronPDF
var pdf = PdfDocument.FromFile("input.pdf");

Imports GemBox.Pdf
Imports IronPdf

Dim doc = PdfDocument.Load("input.pdf")

Dim pdf = PdfDocument.FromFile("input.pdf")

$vbLabelText $csharpLabel

Problema 4: Diferenças no método de salvamento

Problema: a assinatura do método document.Save() difere.

Solução: Use SaveAs():

// GemBox PDF
document.Save("output.pdf");

// IronPDF
pdf.SaveAs("output.pdf");

// GemBox PDF
document.Save("output.pdf");

// IronPDF
pdf.SaveAs("output.pdf");

' GemBox PDF
document.Save("output.pdf")

' IronPDF
pdf.SaveAs("output.pdf")

$vbLabelText $csharpLabel

Lista de verificação para migração

Pré-migração

Inventariar todo o uso de PDFs do GemBox na base de código.
Identificar layouts baseados em coordenadas que precisam de conversão para HTML.
Avalie os limites de parágrafo atuais que afetam seu código.
Obtenha a chave de licença do IronPDF
Criar branch de migração no controle de versão

Migração de código

Remover o pacote NuGet GemBox PDF: dotnet remove package GemBox.Pdf
Instale o pacote NuGet IronPDF : dotnet add package IronPdf
Atualizar importações de namespace
Substitua ComponentInfo.SetLicense() por IronPdf.License.LicenseKey
Converter PdfDocument.Load() para PdfDocument.FromFile()
Converter document.Save() para pdf.SaveAs()
Substituir texto baseado em coordenadas por conteúdo HTML
Converter PdfFormattedText para HTML com estilo CSS
Atualizar operações de mesclagem para usar PdfDocument.Merge()

Testando

Verifique se todos os documentos foram gerados corretamente.
Verificar se a aparência do documento corresponde às expectativas.
Geração de tabelas de teste (anteriormente limitada pela regra dos 20 parágrafos)
Verifique se a extração de texto funciona corretamente.
Testar operações de mesclagem e divisão
Validar a funcionalidade de segurança/criptografia

Pós-migração

Remover chaves de licença do GemBox PDF
Atualizar documentação
Treinar a equipe na abordagem HTML/CSS para PDFs Aproveite conteúdo ilimitado, sem limite de parágrafos!

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Experimente gratuitamente por 30 dias.

Como migrar do GemBox PDF para o IronPDF em C#

Por que migrar do PDF GemBox para o IronPDF?

Os Desafios do GemBox PDF

Comparação entre PDF GemBox e IronPDF

Avaliação da Complexidade da Migração

Esforço estimado por funcionalidade

Mudança de paradigma

Antes de começar

Pré-requisitos

Identificar todos os usos do GemBox PDF

Alterações no pacote NuGet

Migração de Início Rápido

Etapa 1: Atualizar a configuração da licença

Etapa 2: Atualizar importações de namespace

Etapa 3: Padrão de Conversão Básico

Referência completa da API

Mapeamento de Namespace

Mapeamento de Classes Principais

Operações de Documentos

Operações de página

Operações de texto e conteúdo

Exemplos de migração de código

Exemplo 1: Conversão de HTML para PDF

Exemplo 2: Mesclar arquivos PDF

Exemplo 3: Adicionar texto a um PDF

Exemplo 4: Criando tabelas (A maior melhoria!)

Notas críticas sobre migração

Coordenadas para posicionamento CSS

Indexação de páginas

Configurações de segurança

Solução de problemas

Problema 1: Texto formatado em PDF não encontrado

Problema 2: Método DrawText não encontrado

Problema 3: Diferenças no carregamento de documentos

Problema 4: Diferenças no método de salvamento

Lista de verificação para migração

Pré-migração

Migração de código

Testando

Pós-migração

Artigos relacionados

Como migrar do ZetPDF para o IronPDF em C#

Como migrar do Scryber.Core para o IronPDF em C#

Como migrar do XFINIUM.PDF para o IronPDF em C#

Want to deploy IronSuite to a live project for FREE?

What’s included?

Thank You

Want to deploy IronSuite to a live project for FREE?

What’s included?

Aprovado por milhões de engenheiros em todo o mundo.

Equipe de suporte de ferro