PRZEWODNIKI MIGRACJI

Jak przeprowadzić migrację z GemBox PDF do IronPDF w języku C#

Zaktualizowano:1 lutego, 2026

Przejście zGemBox PDFnaIronPDFzmienia proces pracy z plikami PDF w środowisku .NET z programowego tworzenia dokumentów opartego na współrzędnych na nowoczesne renderowanie oparte na HTML/CSS. Niniejszy przewodnik zawiera kompleksową, szczegółową ścieżkę migracji, która eliminuje ograniczenia dotyczące liczby akapitów i upraszcza tworzenie dokumentów dla profesjonalnych programistów .NET.

Dlaczego warto przejść zGemBox PDFna IronPDF

Wyzwania związane z GemBox PDF

GemBox PDF to wydajny komponent .NET do obsługi plików PDF, ale ma poważne ograniczenia, które wpływają na rzeczywisty proces tworzenia oprogramowania:

Limit 20 akapitów w wersji darmowej: Wersja darmowa ogranicza liczbę akapitów do 20, a komórki tabel są wliczane do tego limitu. Prosta tabela o wymiarach 10 wierszy i 5 kolumn wykorzystuje 50 "akapitów", co sprawia, że wersja darmowa nie nadaje się nawet do podstawowych dokumentów biznesowych.
Brak konwersji HTML do PDF:GemBox PDFwymaga programowego tworzenia dokumentów. Należy obliczyć współrzędne i ręcznie ustawić położenie każdego elementu — nie ma prostej funkcji "renderuj ten kod HTML".
Układ oparty na współrzędnych: W przeciwieństwie do HTML/CSS, gdzie układ jest płynny,GemBox PDFwymaga obliczenia dokładnych pozycji X/Y dla każdego elementu tekstowego, obrazu i kształtu.
Ograniczony zestaw funkcji: W porównaniu z kompleksowymi bibliotekami PDF,GemBox PDFkoncentruje się na podstawowych operacjach — odczytywaniu, zapisywaniu, scalaniu, dzieleniu — bez zaawansowanych funkcji, takich jak renderowanie HTML czy obsługa nowoczesnego CSS.
Wyłącznie programowo: Każda zmiana projektu wymaga zmian w kodzie. Chcesz dostosować odstępy? Przelicz współrzędne. Chcesz zmienić rozmiar czcionki? Dostosuj wszystkie pozycje Y poniżej.
Liczenie komórek tabeli: Limit akapitów obejmuje komórki tabeli, a nie tylko widoczne akapity. To sprawia, że wersja darmowa jest praktycznie bezużyteczna w przypadku dokumentów zawierających tabele.
Krzywa uczenia się w zakresie projektowania: Programiści muszą myśleć w kategoriach współrzędnych, a nie przepływu dokumentu, co sprawia, że proste zadania, takie jak "dodaj akapit", stają się zaskakująco złożone.

PorównanieGemBox PDFi IronPDF

Aspekt	GemBox PDF	IronPDF
Ograniczenia wersji darmowej	20 akapitów (w tym komórki tabeli)	Tylko znak wodny, bez ograniczeń dotyczących treści
HTML do PDF	Nieobsługiwane	Pełny silnik Chromium
Podejście do układu graficznego	Ręczne, oparte na współrzędnych	Układ HTML/CSS
Tabele	Wlicza się do limitu akapitów	Bez ograniczeń, użyj tabel HTML
Nowoczesny CSS	Nie dotyczy	Flexbox, Grid, animacje CSS3
Obsługa JavaScript	Nie dotyczy	Pełne wykonywanie kodu JavaScript
Zmiany w projekcie	Przelicz współrzędne	Edytuj HTML/CSS
Krzywa uczenia się	Układ współrzędnych PDF	HTML/CSS (znajomość sieci)

Dla zespołów planujących wdrożenie .NET 10 i C# 14 w latach 2025 i 2026,IronPDFzapewnia przyszłościową platformę, która wykorzystuje znane technologie internetowe do generowania plików PDF.

Ocena złożoności migracji

Szacowany nakład pracy według funkcji

Funkcja	Złożoność migracji
Wczytywanie/zapisywanie plików PDF	Bardzo niski
Łączenie plików PDF	Bardzo niski
Podział plików PDF	Low
Ekstrakcja tekstu	Bardzo niski
Dodaj tekst	Medium
Tabele	Low
Obrazy	Low
Znaki wodne	Low
Ochrona hasłem	Medium
Pola formularza	Medium

Zmiana paradygmatu

Największą zmianą w migracjiGemBox PDFjest przejście z układu opartego na współrzędnych na układ HTML/CSS:

GemBox PDF:  "Narysuj tekst w pozycji (100, 700)"
IronPDF:     "Renderuj ten kod HTML ze stylami CSS"

Ta zmiana paradygmatu jest zazwyczaj łatwiejsza dla programistów zaznajomionych z technologiami internetowymi, ale wymaga innego podejścia do plików PDF.

Zanim zaczniesz

Wymagania wstępne

Wersja .NET:IronPDFobsługuje .NET Framework 4.6.2+ oraz .NET Core 2.0+ / .NET 5/6/7/8/9+
Klucz licencyjny: Uzyskaj klucz licencyjnyIronPDFna stronie ironpdf.com
Kopia zapasowa: Utwórz gałąź do prac migracyjnych
Znajomość HTML/CSS: Podstawowa znajomość jest pomocna, ale nie jest wymagana

Zidentyfikuj wszystkie przypadki użycia GemBox PDF

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

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

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

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

SHELL

Zmiany w pakiecie 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

Szybki start – migracja

Krok 1: Zaktualizuj konfigurację licencji

Przed (GemBox PDF):

// Must call before anyGemBox PDFoperations
ComponentInfo.SetLicense("FREE-LIMITED-KEY");
// Or for professional:
ComponentInfo.SetLicense("YOUR-PROFESSIONAL-LICENSE");

// Must call before anyGemBox PDFoperations
ComponentInfo.SetLicense("FREE-LIMITED-KEY");
// Or for professional:
ComponentInfo.SetLicense("YOUR-PROFESSIONAL-LICENSE");

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

$vbLabelText $csharpLabel

Po (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

Krok 2: Zaktualizuj importy przestrzeni nazw

// 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

Krok 3: Podstawowy wzorzec konwersji

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

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

Po (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

Kluczowe różnice:

Nie są wymagane obliczenia współrzędnych
HTML/CSS zamiast układu programowego
Brak ograniczeń dotyczących liczby akapitów
Prostszy, bardziej czytelny kod

Kompletna dokumentacija API

Mapowanie przestrzeni nazw

GemBox PDF	IronPDF
`GemBox.Pdf`	`IronPdf`
`GemBox.Pdf.Content`	`IronPdf` (treść jest w formacie HTML)
`GemBox.Pdf.Security`	`IronPdf` (SecuritySettings)
`GemBox.Pdf.Forms`	`IronPdf.Forms`

Mapowanie klas podstawowych

GemBox PDF	IronPDF	Opis
`PdfDocument`	`PdfDocument`	Główna klasa dokumentu PDF
`PdfPage`	`PdfDocument.Pages[i]`	Przedstawienie strony
`PdfContent`	Nie dotyczy (użyj HTML)	Treść strony
`PdfFormattedText`	Nie dotyczy (użyj HTML)	Tekst sformatowany
`PdfPoint`	Nie dotyczy (użyj pozycjonowania CSS)	Współrzędne pozycjonowania
`ComponentInfo.SetLicense()`	`IronPdf.License.LicenseKey`	Zarządzanie licencjami

Operacje na dokumentach

GemBox PDF	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` lub `pdf.BinaryData`

Operacje na stronach

GemBox PDF	IronPDF
`document.Pages.Add()`	Utwórz poprzez renderowanie HTML
`document.Pages.Count`	`pdf.PageCount`
`document.Pages[index]`	`pdf.Pages[index]`
`document.Pages.AddClone(pages)`	`PdfDocument.Merge()`

Operacje związane z tekstem i treścią

GemBox PDF	IronPDF
`new PdfFormattedText()`	Ciąg znaków 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)`

Przykłady migracji kodu

Przykład 1: Konwersja HTML do PDF

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

// 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

Po (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

ChromePdfRenderer firmyIronPDFwykorzystuje nowoczesny silnik Chromium do dokładnego renderowania HTML/CSS/JavaScript. W przeciwieństwie do ograniczonej obsługi HTML w GemBox PDF,IronPDFmoże renderować dowolną zawartość HTML z pełną obsługą CSS3 i JavaScript. Więcej opcji renderowania można znaleźć w dokumentacji dotyczącej konwersji HTML do PDF.

Przykład 2: Łączenie plików PDF

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

// 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

Po (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

Metoda statyczna Merge firmyIronPDFupraszcza operację — nie ma potrzeby tworzenia pustego dokumentu i klonowania stron pojedynczo. Dowiedz się więcej o łączeniu i dzieleniu plików PDF.

Przykład 3: Dodaj tekst do pliku PDF

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

// 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

Po (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

W celu dodawania tekstu do istniejących plików PDF,IronPDFudostępnia klasę TextStamper, która zapewnia precyzyjną kontrolę pozycjonowania. W przypadku nowych dokumentów wystarczy umieścić tekst w szablonie HTML. Dodatkowe opcje można znaleźć w dokumentacji dotyczącej stemplowania.

Przykład 4: Tworzenie tabel (największa poprawa!)

Przed (GemBox PDF) – Każda komórka wlicza się do limitu 20 akapitów:

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

Po (IronPDF) – Bez ograniczeń, poprawne tabele HTML:

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

Jest to najważniejsze ulepszenie w migracji GemBox PDF. Tabele, których nie można było wyświetlić w darmowej wersji GemBox PDF, działają idealnie wIronPDFz pełną obsługą stylów CSS.

Ważne uwagi dotyczące migracji

Dostosowanie do pozycjonowania CSS

Jeśli potrzebujesz pozycjonowania z dokładnością do piksela (podobnego do układu współrzędnych GemBox PDF), użyj pozycjonowania absolutnego 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

Indeksowanie stron

Zarówno GemBox PDF, jak iIronPDFużywają stron indeksowanych od 0, co sprawia, że ten aspekt migracji jest prosty:

// 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

Ustawienia zabezpieczeń

// 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

Rozwiązywanie problemów

Problem 1: Nie znaleziono PdfFormattedText

Problem: PdfFormattedText nie istnieje w IronPDF.

Rozwiązanie: Użyj kodu HTML ze stylami 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

Problem 2: Nie znaleziono metody DrawText

Problem: page.Content.DrawText() niedostępny.

Rozwiązanie: Tworzenie treści poprzez renderowanie HTML lub użycie szablonów:

// 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

Problem 3: Różnice w ładowaniu dokumentów

Problem: PdfDocument.Load() nie znaleziono.

Rozwiązanie: Użyj PdfDocument.FromFile() lub 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

Problem 4: Różnice w metodach zapisywania

Problem: document.Save() sygnatura metody jest inna.

Rozwiązanie: Użyj 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 kontrolna migracji

Przed migracją

Sporządź spis wszystkich miejsc użyciaGemBox PDFw kodzie źródłowym
Zidentyfikuj układy oparte na współrzędnych, które wymagają konwersji do HTML
Oceń aktualne ograniczenia dotyczące długości akapitów, które mają wpływ na Twój kod
Uzyskaj klucz licencyjny IronPDF
Utwórz gałąź migracji w systemie kontroli wersji

Migracja kodu

Usuń pakietGemBox PDFNuGet: dotnet remove package GemBox.Pdf
Zainstaluj pakietIronPDFNuGet: dotnet add package IronPdf
Zaktualizuj importy przestrzeni nazw
Zastąp ComponentInfo.SetLicense() przez IronPdf.License.LicenseKey
Zamień PdfDocument.Load() na PdfDocument.FromFile()
Zamień document.Save() na pdf.SaveAs()
Zastąp tekst oparty na współrzędnych treścią HTML
Przekonwertuj PdfFormattedText na HTML ze stylizacją CSS
Zaktualizuj operacje scalania, aby korzystały z PdfDocument.Merge()

Testowanie

Sprawdź, czy wszystkie dokumenty generują się poprawnie
Sprawdź, czy wygląd dokumentu jest zgodny z oczekiwaniami
Generowanie tabeli testowej (wcześniej ograniczone zasadą 20 akapitów)
Sprawdź, czy wyodrębnianie tekstu działa poprawnie
Testowanie operacji scalania i dzielenia
Sprawdź działanie funkcji bezpieczeństwa/szyfrowania

Po migracji

Usuń klucze licencyjne GemBox PDF
Aktualizacja dokumentacji
Przeszkol zespół w zakresie podejścia HTML/CSS do plików PDF
Ciesz się nieograniczoną ilością treści bez limitów akapitów!

Curtis Chau

Czat z zespołem inżynierów teraz

Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej

Powiązane artykuły

Zaktualizowano 1 lutego, 2026

Jak przeprowadzić migrację z ZetPDF do IronPDF w języku C#

Opanuj migrację z ZetPDF do IronPDF dzięki temu kompletnemu przewodnikowi w języku C#. Przejdź z biblioteki opartej na współrzędnych na nowoczesne rozwiązanie do konwersji HTML na PDF. Zawiera przykłady kodu dotyczące konwersji HTML, łączenia plików PDF oraz usuwania zależności od PDFSharp.

Czytaj więcej

Zaktualizowano 1 lutego, 2026

Jak przeprowadzić migrację z Scryber.Core do IronPDF w języku C#

Opanuj migrację z Scryber.Core do IronPDF dzięki temu kompletnemu przewodnikowi w języku C#. Przejdź z niestandardowego parsowania XML/HTML na nowoczesny renderer Chromium. Zawiera przykłady kodu dotyczące konwersji HTML, renderowania adresów URL oraz zastępowania zastrzeżonych powiązań.

Czytaj więcej

Zaktualizowano 1 lutego, 2026

Jak przeprowadzić migrację z XFINIUM.PDF do IronPDF w języku C#

Opanuj migrację z XFINIUM.PDF do IronPDF dzięki temu kompletnemu przewodnikowi w języku C#. Przejdź od ręcznego pozycjonowania opartego na współrzędnych do deklaratywnego renderowania HTML/CSS. Zawiera przykłady kodu dotyczące zastępowania prymitywów graficznych i automatycznego układu.

Czytaj więcej

Jak przejść z Ghostscript GPL na IronPDF w języku C#

Jak przejść z GdPicture.NET SDK n...

Rozpocznij Bezpłatny 30-dniowy Okres Próbny

Jak przeprowadzić migrację z GemBox PDF do IronPDF w języku C#

Dlaczego warto przejść zGemBox PDFna IronPDF

Wyzwania związane z GemBox PDF

PorównanieGemBox PDFi IronPDF

Ocena złożoności migracji

Szacowany nakład pracy według funkcji

Zmiana paradygmatu

Zanim zaczniesz

Wymagania wstępne

Zidentyfikuj wszystkie przypadki użycia GemBox PDF

Zmiany w pakiecie NuGet

Szybki start – migracja

Krok 1: Zaktualizuj konfigurację licencji

Krok 2: Zaktualizuj importy przestrzeni nazw

Krok 3: Podstawowy wzorzec konwersji

Kompletna dokumentacija API

Mapowanie przestrzeni nazw

Mapowanie klas podstawowych

Operacje na dokumentach

Operacje na stronach

Operacje związane z tekstem i treścią

Przykłady migracji kodu

Przykład 1: Konwersja HTML do PDF

Przykład 2: Łączenie plików PDF

Przykład 3: Dodaj tekst do pliku PDF

Przykład 4: Tworzenie tabel (największa poprawa!)

Ważne uwagi dotyczące migracji

Dostosowanie do pozycjonowania CSS

Indeksowanie stron

Ustawienia zabezpieczeń

Rozwiązywanie problemów

Problem 1: Nie znaleziono PdfFormattedText

Problem 2: Nie znaleziono metody DrawText

Problem 3: Różnice w ładowaniu dokumentów

Problem 4: Różnice w metodach zapisywania

Lista kontrolna migracji

Przed migracją

Migracja kodu

Testowanie

Po migracji

Powiązane artykuły

Jak przeprowadzić migrację z ZetPDF do IronPDF w języku C#

Jak przeprowadzić migrację z Scryber.Core do IronPDF w języku C#

Jak przeprowadzić migrację z XFINIUM.PDF do IronPDF w języku C#

Następny krok: Rozpocznij darmową 30-dniową wersję próbną

Następny krok: Rozpocznij darmową 30-dniową wersję próbną

Want to deploy IronSuite to a live project for FREE?

What’s included?

Zaufane przez miliony inżynierów na całym świecie

Zespol wsparcia Iron