MIGRATIONSLEITFäDEN

Migrieren von Aspose.PDF zu IronPDF in C#

Veröffentlicht:Januar 7, 2026

Migrieren von Aspose.PDF zu IronPDF: Vollständiger C#-Migrationsleitfaden

Aspose.PDF for .NET ist eine etablierte PDF-Bibliothek für Unternehmen, die für ihre umfassenden Funktionen zur Dokumentenmanipulation bekannt ist. Das Premium-Preismodell ($1.199+ pro Entwickler und Jahr), die dokumentierten Leistungsprobleme (in einigen Fällen bis zu 30 Mal langsamer) und die veraltete Flying Saucer HTML-Rendering-Engine sind jedoch zwingende Gründe für Entwicklungsteams, nach Alternativen zu suchen. Dieser umfassende Leitfaden bietet einen schrittweisen Migrationspfad von Aspose.PDF zuIronPDF- einer nativen .NET-PDF-Bibliothek mit modernem Chromium-basiertem Rendering, hervorragender CSS3-Unterstützung und einmaliger unbefristeter Lizenzierung.

Warum von Aspose.PDF abwandern?

Obwohl Aspose.PDF Funktionen auf Unternehmensebene bietet, gibt es mehrere Faktoren, die Entwicklungsteams dazu veranlassen, nach modernen Alternativen für ihre PDF-Erzeugungsanforderungen zu suchen.

Kostenvergleich

Aspose.PDF verwendet ein traditionelles Unternehmenslizenzierungsmodell mit jährlichen Verlängerungen, die sich im Laufe der Zeit erheblich summieren:

Aspekt	Aspose.PDF	IronPDF
Startpreis	1.199 $/Entwickler/Jahr	$749 einmalig (Lite)
Lizenzmodell	Jahresabonnement + Erneuerung	Unbefristete Lizenz
OEM-Lizenz	$5.997+ zusätzlich	Eingeschlossen in höhere Stufen
Unterstützung	Zusätzliche Kostenstufen	Enthalten
Gesamtkosten für 3 Jahre	$3.597+ pro Entwickler	749 $ einmalig

HTML Rendering Engine Vergleich

Aspose.PDF verwendet die Flying Saucer CSS-Engine, die mit modernen Webstandards nicht zurechtkommt.IronPDFnutzt eine vollständige Chromium-Rendering-Engine:

Feature	Aspose.PDF (Fliegende Untertasse)	IronPDF(Chromium)
CSS3-Unterstützung	Begrenzt (älteres CSS)	Vollständig CSS3
Flexbox/Grid	Nicht unterstützt	Volle Unterstützung
JavaScript	Sehr begrenzt	Volle Unterstützung
Web-Schriftarten	Teilweise	Vollständige
Modernes HTML5	Beschränkt	Vollständige
Wiedergabequalität	Variable	Pixelgenaue

Dokumentierte Performance-Probleme

Benutzer haben über erhebliche Leistungsunterschiede zwischen den beiden Bibliotheken berichtet:

Metrik	Aspose.PDF	IronPDF
HTML-Rendering	Dokumentierte Verlangsamungen (in einigen Fällen 30x langsamer)	Optimierte Chromium-Engine
Große Dokumente	Gemeldete Speicherprobleme	Effizientes Streaming
Linux-Leistung	Hohe CPU- und Speicherlecks gemeldet	Stabile

Aspose.PDF vs. IronPDF: Hauptunterschiede

Aspekt	Aspose.PDF	IronPDF
Preisgestaltung	$1.199/Entwickler/Jahr (Abonnement)	$749 einmalig (Lite)
HTML Engine	Flying Saucer (eingeschränktes CSS)	Chromium (vollständig CSS3/JS)
Leistung	Dokumentierte Verlangsamungen	Optimiert
Lizenzmodell	Jährliche Erneuerung + .lic-Datei	Ewiger + codebasierter Schlüssel
Linux-Unterstützung	Gemeldete Probleme (CPU, Speicher)	Stabile
Seitenindizierung	1-basiert (`Seiten[1]`)	0-basiert (`Seiten[0]`)

Vorbereitung auf die Migration

Voraussetzungen

Stellen Sie sicher, dass Ihre Umgebung diese Anforderungen erfüllt:

.NET Framework 4.6.2+ oder .NET Core 3.1 / .NET 5-9
Visual Studio 2019+ oder VS Code mit C#-Erweiterung
NuGet Package Manager Zugang
IronPDF-Lizenzschlüssel (kostenlose Testversion erhältlich unter ironpdf.com)

Audit der Aspose.PDF-Verwendung

Führen Sie diese Befehle in Ihrem Lösungsverzeichnis aus, um alle Aspose.PDF-Referenzen zu identifizieren:

# Find all Aspose.Pdf using statements
grep -r "using Aspose.Pdf" --include="*.cs" .

# Find HtmlLoadOptions usage
grep -r "HtmlLoadOptions\|HtmlFragment" --include="*.cs" .

# Find Facades usage
grep -r "PdfFileEditor\|PdfFileMend\|PdfFileStamp" --include="*.cs" .

# Find TextAbsorber usage
grep -r "TextAbsorber\|TextFragmentAbsorber" --include="*.cs" .

# Find all Aspose.Pdf using statements
grep -r "using Aspose.Pdf" --include="*.cs" .

# Find HtmlLoadOptions usage
grep -r "HtmlLoadOptions\|HtmlFragment" --include="*.cs" .

# Find Facades usage
grep -r "PdfFileEditor\|PdfFileMend\|PdfFileStamp" --include="*.cs" .

# Find TextAbsorber usage
grep -r "TextAbsorber\|TextFragmentAbsorber" --include="*.cs" .

SHELL

Bahnbrechende Änderungen, die zu erwarten sind

Aspose.PDF-Muster	Änderung erforderlich
`Neues Dokument()`+ `Pages.Add()`	Stattdessen HTML-Rendering verwenden
`HtmlLoadOptions`	`ChromePdfRenderer.RenderHtmlAsPdf()`
`TextFragment` + manuelle Positionierung	CSS-basierte Positionierung
`PdfFileEditor.Concatenate()`	`PdfDocument.Merge()`
`TextFragmentAbsorber`	`pdf.ExtractAllText()`
`Bildstempel`	HTML-basierte Wasserzeichen
`.lic` Datei-Lizenzierung	Code-basierter Lizenzschlüssel
1-basierte Seitenindizierung	0-basierte Seitenindizierung

Schritt-für-Schritt-Migrationsprozess

Schritt 1: NuGet-Pakete aktualisieren

Entfernen Sie Aspose.PDF und installieren Sie IronPDF:

# Remove Aspose.PDF
dotnet remove package Aspose.PDF

# Install IronPDF
dotnet add package IronPdf

# Remove Aspose.PDF
dotnet remove package Aspose.PDF

# Install IronPDF
dotnet add package IronPdf

SHELL

Oder über die Paketmanager-Konsole:

Uninstall-Package Aspose.PDF
Install-Package IronPdf

Schritt 2: Namensraumreferenzen aktualisieren

Ersetzen Sie die Namensräume von Aspose.PDF durch IronPDF:

// Remove these
using Aspose.Pdf;
using Aspose.Pdf.Text;
using Aspose.Pdf.Facades;
using Aspose.Pdf.Generator;

// Add these
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Editing;

// Remove these
using Aspose.Pdf;
using Aspose.Pdf.Text;
using Aspose.Pdf.Facades;
using Aspose.Pdf.Generator;

// Add these
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Editing;

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Schritt 3: Lizenzkonfiguration aktualisieren

Aspose.PDF verwendet die .lic-Datei-Lizenzierung.IronPDFverwendet einen einfachen codebasierten Schlüssel.

Aspose.PDF Implementierung:

var license = new Aspose.Pdf.License();
license.SetLicense("Aspose.Pdf.lic");

var license = new Aspose.Pdf.License();
license.SetLicense("Aspose.Pdf.lic");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF-Implementierung:

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

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

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

$vbLabelText $csharpLabel

Komplette API-Migrationsreferenz

Kernklassen-Zuordnung

Aspose.PDF-Klasse	IronPDF-Äquivalent	Notizen
`Dokument`	`PdfDocument`	Klasse des Hauptdokuments
`HtmlLoadOptions`	`ChromePdfRenderer`	HTML zu PDF
`TextFragmentAbsorber`	`PdfDocument.ExtractAllText()`	Textextraktion
`PdfFileEditor`	`PdfDocument.Merge()`	Zusammenführen/Splitten
`TextStempel` / `BildStempel`	`PdfDocument.ApplyWatermark()`	Wasserzeichen
`Lizenz`	`IronPdf.Lizenz`	Lizenzierung

Dokumentenoperationen

Aspose.PDF-Methode	IronPDF-Methode	Notizen
`Neues Dokument()`	`new PdfDocument()`	Leeres Dokument
`Neues Dokument(Pfad)`	`PdfDocument.FromFile(path)`	Aus Datei laden
`doc.Save(Pfad)`	`pdf.SaveAs(Pfad)`	In Datei speichern
`doc.Pages.Count`	`pdf.PageCount`	Anzahl der Seiten
`doc.Pages.Delete(index)`	`pdf.RemovePage(index)`	Seite entfernen

HTML-zu-PDF-Konvertierung

Aspose.PDF-Methode	IronPDF-Methode	Notizen
`new HtmlLoadOptions()`	`new ChromePdfRenderer()`	HTML-Renderer
`Neues Dokument(stream, htmlOptions)`	`renderer.RenderHtmlAsPdf(html)`	HTML-Zeichenkette
`Neues Dokument(Pfad, htmlOptionen)`	`renderer.RenderHtmlFileAsPdf(path)`	HTML-Datei

Beispiele für die Code-Migration

HTML-String in PDF konvertieren

Die gängigste Aspose.PDF-Operation verdeutlicht den grundlegenden Unterschied in der Herangehensweise - Aspose.PDF erfordert das Einwickeln von HTML in einen MemoryStream, währendIronPDFStrings direkt akzeptiert.

Aspose.PDF Implementierung:

// NuGet: Install-Package Aspose.PDF
using Aspose.Pdf;
using System;
using System.IO;
using System.Text;

class Program
{
    static void Main()
    {
        string htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF from HTML string.</p></body></html>";

        using (var stream = new MemoryStream(Encoding.UTF8.GetBytes(htmlContent)))
        {
            var htmlLoadOptions = new HtmlLoadOptions();
            var document = new Document(stream, htmlLoadOptions);
            document.Save("output.pdf");
        }

        Console.WriteLine("PDF created from HTML string");
    }
}

// NuGet: Install-Package Aspose.PDF
using Aspose.Pdf;
using System;
using System.IO;
using System.Text;

class Program
{
    static void Main()
    {
        string htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF from HTML string.</p></body></html>";

        using (var stream = new MemoryStream(Encoding.UTF8.GetBytes(htmlContent)))
        {
            var htmlLoadOptions = new HtmlLoadOptions();
            var document = new Document(stream, htmlLoadOptions);
            document.Save("output.pdf");
        }

        Console.WriteLine("PDF created from HTML string");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF-Implementierung:

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

class Program
{
    static void Main()
    {
        string htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF from HTML string.</p></body></html>";

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

        Console.WriteLine("PDF created from HTML string");
    }
}

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

class Program
{
    static void Main()
    {
        string htmlContent = "<html><body><h1>Hello World</h1><p>This is a PDF from HTML string.</p></body></html>";

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

        Console.WriteLine("PDF created from HTML string");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF macht den MemoryStream-Wrapper komplett überflüssig - eine sauberere, intuitivere API.

HTML-Datei zu PDF

Aspose.PDF Implementierung:

// NuGet: Install-Package Aspose.PDF
using Aspose.Pdf;
using System;

class Program
{
    static void Main()
    {
        var htmlLoadOptions = new HtmlLoadOptions();
        var document = new Document("input.html", htmlLoadOptions);
        document.Save("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

// NuGet: Install-Package Aspose.PDF
using Aspose.Pdf;
using System;

class Program
{
    static void Main()
    {
        var htmlLoadOptions = new HtmlLoadOptions();
        var document = new Document("input.html", htmlLoadOptions);
        document.Save("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF-Implementierung:

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlFileAsPdf("input.html");
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlFileAsPdf("input.html");
        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF created successfully");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Mehrere PDFs zusammenführen

Aspose.PDF erfordert eine manuelle Iteration der Seiten.IronPDFbietet eine statische Merge-Methode.

Aspose.PDF Implementierung:

// NuGet: Install-Package Aspose.PDF
using Aspose.Pdf;
using System;

class Program
{
    static void Main()
    {
        var document1 = new Document("file1.pdf");
        var document2 = new Document("file2.pdf");

        foreach (Page page in document2.Pages)
        {
            document1.Pages.Add(page);
        }

        document1.Save("merged.pdf");
        Console.WriteLine("PDFs merged successfully");
    }
}

// NuGet: Install-Package Aspose.PDF
using Aspose.Pdf;
using System;

class Program
{
    static void Main()
    {
        var document1 = new Document("file1.pdf");
        var document2 = new Document("file2.pdf");

        foreach (Page page in document2.Pages)
        {
            document1.Pages.Add(page);
        }

        document1.Save("merged.pdf");
        Console.WriteLine("PDFs merged successfully");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF-Implementierung:

// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;

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

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

        Console.WriteLine("PDFs merged successfully");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using System;
using System.Collections.Generic;

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

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

        Console.WriteLine("PDFs merged successfully");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Textextraktion

Aspose.PDF Implementierung:

using Aspose.Pdf;
using Aspose.Pdf.Text;

var document = new Document("document.pdf");
var absorber = new TextAbsorber();

foreach (Page page in document.Pages)
{
    page.Accept(absorber);
}

string extractedText = absorber.Text;
Console.WriteLine(extractedText);

using Aspose.Pdf;
using Aspose.Pdf.Text;

var document = new Document("document.pdf");
var absorber = new TextAbsorber();

foreach (Page page in document.Pages)
{
    page.Accept(absorber);
}

string extractedText = absorber.Text;
Console.WriteLine(extractedText);

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF-Implementierung:

using IronPdf;

var pdf = PdfDocument.FromFile("document.pdf");

// Extract all text - one line!
string allText = pdf.ExtractAllText();
Console.WriteLine(allText);

// Or extract from specific page
string page1Text = pdf.ExtractTextFromPage(0);

using IronPdf;

var pdf = PdfDocument.FromFile("document.pdf");

// Extract all text - one line!
string allText = pdf.ExtractAllText();
Console.WriteLine(allText);

// Or extract from specific page
string page1Text = pdf.ExtractTextFromPage(0);

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF vereinfacht die Textextraktion von mehreren Schritten auf einen einzigen Methodenaufruf.

Wasserzeichen hinzufügen

Aspose.PDF Implementierung:

using Aspose.Pdf;
using Aspose.Pdf.Text;

var document = new Document("document.pdf");

var textStamp = new TextStamp("CONFIDENTIAL");
textStamp.Background = true;
textStamp.XIndent = 100;
textStamp.YIndent = 100;
textStamp.Rotate = Rotation.on45;
textStamp.Opacity = 0.5;
textStamp.TextState.Font = FontRepository.FindFont("Arial");
textStamp.TextState.FontSize = 72;
textStamp.TextState.ForegroundColor = Color.Red;

foreach (Page page in document.Pages)
{
    page.AddStamp(textStamp);
}

document.Save("watermarked.pdf");

using Aspose.Pdf;
using Aspose.Pdf.Text;

var document = new Document("document.pdf");

var textStamp = new TextStamp("CONFIDENTIAL");
textStamp.Background = true;
textStamp.XIndent = 100;
textStamp.YIndent = 100;
textStamp.Rotate = Rotation.on45;
textStamp.Opacity = 0.5;
textStamp.TextState.Font = FontRepository.FindFont("Arial");
textStamp.TextState.FontSize = 72;
textStamp.TextState.ForegroundColor = Color.Red;

foreach (Page page in document.Pages)
{
    page.AddStamp(textStamp);
}

document.Save("watermarked.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF-Implementierung:

using IronPdf;
using IronPdf.Editing;

var pdf = PdfDocument.FromFile("document.pdf");

// HTML-based watermark with full styling control
string watermarkHtml = @"
<div style='
    color: red;
    opacity: 0.5;
    font-family: Arial;
    font-size: 72px;
    font-weight: bold;
    text-align: center;
'>CONFIDENTIAL</div>";

pdf.ApplyWatermark(watermarkHtml,
    rotation: 45,
    verticalAlignment: VerticalAlignment.Middle,
    horizontalAlignment: HorizontalAlignment.Center);

pdf.SaveAs("watermarked.pdf");

using IronPdf;
using IronPdf.Editing;

var pdf = PdfDocument.FromFile("document.pdf");

// HTML-based watermark with full styling control
string watermarkHtml = @"
<div style='
    color: red;
    opacity: 0.5;
    font-family: Arial;
    font-size: 72px;
    font-weight: bold;
    text-align: center;
'>CONFIDENTIAL</div>";

pdf.ApplyWatermark(watermarkHtml,
    rotation: 45,
    verticalAlignment: VerticalAlignment.Middle,
    horizontalAlignment: HorizontalAlignment.Center);

pdf.SaveAs("watermarked.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF verwendet HTML/CSS-basiertes Wasserzeichen und bietet damit volle Kontrolle über die Gestaltung durch vertraute Webtechnologien.

Passwortschutz

Aspose.PDF Implementierung:

using Aspose.Pdf;

var document = new Document("document.pdf");
document.Encrypt("userPassword", "ownerPassword", DocumentPrivilege.ForbidAll, CryptoAlgorithm.AESx256);
document.Save("protected.pdf");

using Aspose.Pdf;

var document = new Document("document.pdf");
document.Encrypt("userPassword", "ownerPassword", DocumentPrivilege.ForbidAll, CryptoAlgorithm.AESx256);
document.Save("protected.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF-Implementierung:

using IronPdf;

var pdf = PdfDocument.FromFile("document.pdf");

// Set passwords
pdf.SecuritySettings.UserPassword = "userPassword";
pdf.SecuritySettings.OwnerPassword = "ownerPassword";

// Set permissions
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserEdits = PdfEditSecurity.NoEdit;

pdf.SaveAs("protected.pdf");

using IronPdf;

var pdf = PdfDocument.FromFile("document.pdf");

// Set passwords
pdf.SecuritySettings.UserPassword = "userPassword";
pdf.SecuritySettings.OwnerPassword = "ownerPassword";

// Set permissions
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserEdits = PdfEditSecurity.NoEdit;

pdf.SaveAs("protected.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF bietet eine granulare Kontrolle über Berechtigungen durch stark typisierte Eigenschaften. Weitere Optionen finden Sie in der Verschlüsselungsdokumentation.

Kopf- und Fußzeilen

IronPDF-Implementierung:

using IronPdf;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='text-align:center; font-family:Arial; font-size:12px;'>
            Company Header
        </div>",
    DrawDividerLine = true,
    MaxHeight = 30
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='text-align:center; font-family:Arial; font-size:10px;'>
            Page {page} of {total-pages}
        </div>",
    DrawDividerLine = true,
    MaxHeight = 25
};

var pdf = renderer.RenderHtmlAsPdf("<h1>Content here</h1>");
pdf.SaveAs("with_headers.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='text-align:center; font-family:Arial; font-size:12px;'>
            Company Header
        </div>",
    DrawDividerLine = true,
    MaxHeight = 30
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = @"
        <div style='text-align:center; font-family:Arial; font-size:10px;'>
            Page {page} of {total-pages}
        </div>",
    DrawDividerLine = true,
    MaxHeight = 25
};

var pdf = renderer.RenderHtmlAsPdf("<h1>Content here</h1>");
pdf.SaveAs("with_headers.pdf");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

IronPDF unterstützt Platzhalter-Token wie {page} und {total-pages} für die dynamische Seitennummerierung. Weitere Optionen finden Sie in der Kopf- und Fußzeilen-Dokumentation.

Kritische Hinweise zur Migration

Änderung der Seitenindizierung

Aspose.PDF verwendet eine 1-basierte Indizierung.IronPDFverwendet eine 0-basierte Indizierung:

// Aspose.PDF - 1-based indexing
var firstPage = doc.Pages[1];  // First page
var thirdPage = doc.Pages[3];  // Third page

//IronPDF- 0-based indexing
var firstPage = pdf.Pages[0];  // First page
var thirdPage = pdf.Pages[2];  // Third page

// Aspose.PDF - 1-based indexing
var firstPage = doc.Pages[1];  // First page
var thirdPage = doc.Pages[3];  // Third page

//IronPDF- 0-based indexing
var firstPage = pdf.Pages[0];  // First page
var thirdPage = pdf.Pages[2];  // Third page

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Lizenzdatei in Code-Schlüssel

Ersetzen Sie die .lic-Datei-Lizenzierung durch eine codebasierte Aktivierung:

// Aspose.PDF
var license = new Aspose.Pdf.License();
license.SetLicense("Aspose.Pdf.lic");

// IronPDF
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Or from environment variable
IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY");

// Aspose.PDF
var license = new Aspose.Pdf.License();
license.SetLicense("Aspose.Pdf.lic");

// IronPDF
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Or from environment variable
IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

ASP.NET Core Integration

IronPDF-Muster:

[ApiController]
[Route("[controller]")]
public class PdfController : ControllerBase
{
    [HttpGet("generate")]
    public IActionResult GeneratePdf()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Report</h1>");

        return File(pdf.BinaryData, "application/pdf", "report.pdf");
    }

    [HttpGet("generate-async")]
    public async Task<IActionResult> GeneratePdfAsync()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Report</h1>");

        return File(pdf.Stream, "application/pdf", "report.pdf");
    }
}

[ApiController]
[Route("[controller]")]
public class PdfController : ControllerBase
{
    [HttpGet("generate")]
    public IActionResult GeneratePdf()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Report</h1>");

        return File(pdf.BinaryData, "application/pdf", "report.pdf");
    }

    [HttpGet("generate-async")]
    public async Task<IActionResult> GeneratePdfAsync()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Report</h1>");

        return File(pdf.Stream, "application/pdf", "report.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Dependency Injection Konfiguration

// Program.cs
public void ConfigureServices(IServiceCollection services)
{
    // Set license once
    IronPdf.License.LicenseKey = Configuration["IronPdf:LicenseKey"];

    // Register renderer as scoped service
    services.AddScoped<ChromePdfRenderer>();
}

// Program.cs
public void ConfigureServices(IServiceCollection services)
{
    // Set license once
    IronPdf.License.LicenseKey = Configuration["IronPdf:LicenseKey"];

    // Register renderer as scoped service
    services.AddScoped<ChromePdfRenderer>();
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Performance-Optimierung

// 1. Reuse renderer instance
private static readonly ChromePdfRenderer SharedRenderer = new ChromePdfRenderer();

// 2. Disable unnecessary features for speed
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = false; // If not needed
renderer.RenderingOptions.WaitFor.RenderDelay(0);   // No delay
renderer.RenderingOptions.Timeout = 30000;          // 30s max

// 3. Proper disposal
using (var pdf = renderer.RenderHtmlAsPdf(html))
{
    pdf.SaveAs("output.pdf");
}

// 1. Reuse renderer instance
private static readonly ChromePdfRenderer SharedRenderer = new ChromePdfRenderer();

// 2. Disable unnecessary features for speed
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = false; // If not needed
renderer.RenderingOptions.WaitFor.RenderDelay(0);   // No delay
renderer.RenderingOptions.Timeout = 30000;          // 30s max

// 3. Proper disposal
using (var pdf = renderer.RenderHtmlAsPdf(html))
{
    pdf.SaveAs("output.pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Fehlerbehebung bei allgemeinen Migrationsproblemen

Problem: HtmlLoadOptions nicht gefunden

Ersetzen Sie durch ChromePdfRenderer:

// Remove this
var doc = new Document(stream, new HtmlLoadOptions());

// Use this
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlString);

// Remove this
var doc = new Document(stream, new HtmlLoadOptions());

// Use this
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlString);

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Thema: TextFragmentAbsorber nicht gefunden

Verwenden Sie die direkte Textextraktion:

// Remove this
var absorber = new TextFragmentAbsorber();
page.Accept(absorber);
string text = absorber.Text;

// Use this
var pdf = PdfDocument.FromFile("doc.pdf");
string text = pdf.ExtractAllText();

// Remove this
var absorber = new TextFragmentAbsorber();
page.Accept(absorber);
string text = absorber.Text;

// Use this
var pdf = PdfDocument.FromFile("doc.pdf");
string text = pdf.ExtractAllText();

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Issue: PdfFileEditor.Concatenate nicht verfügbar

Verwenden Sie PdfDocument.Merge():

// Remove this
var editor = new PdfFileEditor();
editor.Concatenate(files, output);

// Use this
var pdfs = files.Select(PdfDocument.FromFile).ToList();
var merged = PdfDocument.Merge(pdfs);
merged.SaveAs(output);

// Remove this
var editor = new PdfFileEditor();
editor.Concatenate(files, output);

// Use this
var pdfs = files.Select(PdfDocument.FromFile).ToList();
var merged = PdfDocument.Merge(pdfs);
merged.SaveAs(output);

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

Post-Migrations-Checkliste

Überprüfen Sie nach Abschluss der Codemigration Folgendes:

[Aspose.PDF-Lizenzdateien (.lic) entfernen)
[Überprüfen Sie die Qualität der HTML-Darstellung (CSS Grid, Flexbox sollten jetzt korrekt funktionieren)
[Testen Sie Edge Cases mit großen Dokumenten und komplexem CSS
[Aktualisierung der Seitenindex-Referenzen (1-basiert zu 0-basiert)
[Aktualisieren von Docker-Konfigurationen (falls zutreffend)
[CI/CD-Pipelines mit neuer Lizenzschlüsselkonfiguration aktualisieren
[Dokumentieren Sie neue Muster für Ihr Team

Zukunftssicherheit für Ihre PDF-Infrastruktur

Mit .NET 10 am Horizont und C# 14, das neue Sprachfunktionen einführt, stellt die Wahl einer PDF-Bibliothek mit modernen Rendering-Funktionen die Kompatibilität mit sich entwickelnden Webstandards sicher. Die Chromium-Engine vonIronPDFrendert dasselbe HTML/CSS, das in modernen Browsern funktioniert. Das bedeutet, dass Ihre PDF-Vorlagen auch bei Projekten, die bis ins Jahr 2025 oder 2026 reichen, aktuell bleiben - ohne die CSS-Einschränkungen der Flying Saucer-Engine von Aspose.PDF.

Zusätzliche Ressourcen

Durch die Migration von Aspose.PDF zuIronPDFwird Ihre PDF-Codebasis von einer veralteten HTML-Rendering-Engine auf modernes Chromium-basiertes Rendering umgestellt. Die Abschaffung von MemoryStream-Wrappern, die vereinfachte Textextraktion und die hervorragende CSS3-Unterstützung sorgen für unmittelbare Produktivitätssteigerungen und reduzieren die langfristigen Lizenzkosten von jährlichen Abonnements auf eine einmalige Investition.

Curtis Chau

Jetzt mit dem Ingenieurteam chatten

Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Migrieren von Aspose.PDF zu IronPDF in C#

Migrieren von Aspose.PDF zu IronPDF: Vollständiger C#-Migrationsleitfaden

Warum von Aspose.PDF abwandern?

Kostenvergleich

HTML Rendering Engine Vergleich

Dokumentierte Performance-Probleme

Aspose.PDF vs. IronPDF: Hauptunterschiede

Vorbereitung auf die Migration

Voraussetzungen

Audit der Aspose.PDF-Verwendung

Bahnbrechende Änderungen, die zu erwarten sind

Schritt-für-Schritt-Migrationsprozess

Schritt 1: NuGet-Pakete aktualisieren

Schritt 2: Namensraumreferenzen aktualisieren

Schritt 3: Lizenzkonfiguration aktualisieren

Komplette API-Migrationsreferenz

Kernklassen-Zuordnung

Dokumentenoperationen

HTML-zu-PDF-Konvertierung

Beispiele für die Code-Migration

HTML-String in PDF konvertieren

HTML-Datei zu PDF

Mehrere PDFs zusammenführen

Textextraktion

Wasserzeichen hinzufügen

Passwortschutz

Kopf- und Fußzeilen

Kritische Hinweise zur Migration

Änderung der Seitenindizierung

Lizenzdatei in Code-Schlüssel

ASP.NET Core Integration

Dependency Injection Konfiguration

Performance-Optimierung

Fehlerbehebung bei allgemeinen Migrationsproblemen

Problem: HtmlLoadOptions nicht gefunden

Thema: TextFragmentAbsorber nicht gefunden

Issue: PdfFileEditor.Concatenate nicht verfügbar

Post-Migrations-Checkliste

Zukunftssicherheit für Ihre PDF-Infrastruktur

Zusätzliche Ressourcen

Verwandte Artikel

Wie man von WebView2 zu IronPDF in C# migriert

Wie man von iText zu IronPDF in C# migriert

Migrieren von GemBox PDF zu IronPDF in C#

Nächster Schritt: Kostenlosen 30-Tage-Test starten

Nächster Schritt: Kostenlosen 30-Tage-Test starten

Trusted by Over 2 Million Engineers Worldwide