Wie man von Pdfium zu IronPDF in C# migriert

Pdfium.NET kennenlernen

Pdfium.NET ist ein .NET-Wrapper für die PDFium-Bibliothek von Google, die für ihre Effizienz und Geschwindigkeit beim Rendern von PDF-Dokumenten bekannt ist. Sie hat sich zu einer bedeutenden Bibliothek für Entwickler entwickelt, die sich mit den Feinheiten der PDF-Wiedergabe in C#-Anwendungen befassen und bietet eine originalgetreue Replikation von PDF-Inhalten in .NET-Umgebungen.

Allerdings sind die Möglichkeiten von Pdfium.NET zur Erstellung und Bearbeitung von PDF-Dokumenten trotz seiner hervorragenden Rendering-Fähigkeiten begrenzt. Sie ist hauptsächlich für Anwendungen gedacht, die eine genaue Anzeige von PDF-Inhalten erfordern und weniger auf die Änderung oder Erstellung neuer PDFs ausgerichtet sind.

Kritische Pdfium-Einschränkungen

1. Nur Rendering-Fokus: Kann keine PDFs aus HTML, Bildern oder programmatisch erstellen. Die Fähigkeiten von Pdfium beschränken sich auf das Anzeigen und Rendern von PDFs.

2. Keine PDF-Manipulation: Kann PDF-Inhalte nicht zusammenführen, teilen oder ändern. PDF-Zusammenführung wird nicht nativ unterstützt - Sie müssten eine andere Bibliothek wie iTextSharp oder PdfSharp verwenden.

3. Native Binärabhängigkeiten: Erfordert plattformabhängige PDFium-Binärdateien. Entwickler müssen native PDFium-Binärdateien verwalten, ein Aspekt, der die Komplexität bei der Bereitstellung und Verteilung erhöht.

4. Einsatzkomplexität: Muss native DLLs pro Plattform mit x86-, x64- und Laufzeitordnern bündeln und verwalten.

5. Beschränkte Textextraktion: Grundlegende Textextraktion ohne Formatierung. Die Textextraktion erfordert zusätzliche Arbeit mit Pdfium.NET.

6. Kein HTML zu PDF: Kann Webinhalte nicht in PDF konvertieren. Die Konvertierung von HTML in PDF wird in Pdfium.NET nicht nativ unterstützt.

7. Keine Kopf-/Fußzeilen: Kann keine Seitennummern oder wiederkehrende Inhalte hinzufügen.

8. Keine Wasserzeichen: Kann Dokumente nicht mit Überlagerungen stempeln.

9. Keine Formularunterstützung: Kann PDF-Formulare nicht ausfüllen oder lesen.

10. Keine Sicherheitsfunktionen: Kann PDFs nicht verschlüsseln oder mit einem Passwort schützen.

Vergleich zwischen Pdfium und IronPDF

Für Teams, die die Einführung von .NET 10 und C# 14 bis 2025 und 2026 planen, bietetIronPDFeine vollständig verwaltete Grundlage, die das native Binärmanagement überflüssig macht und gleichzeitig umfassende Funktionen zur Erstellung und Bearbeitung von PDF-Dateien bietet.

Voraussetzungen

1. .NET-Umgebung: .NET Framework 4.6.2+ oder .NET Core 3.1+ / .NET 5/6/7/8/9+
2. NuGet-Zugriff: Möglichkeit zur Installation von NuGet-Paketen
3. IronPDF-Lizenz: Erhalten Sie Ihren Lizenzschlüssel von ironpdf.com

NuGet-Paketänderungen

# Remove Pdfium packages
dotnet remove package Pdfium.NET
dotnet remove package Pdfium.Net.SDK
dotnet remove package PdfiumViewer

# Install IronPDF
dotnet add package IronPdf

# Remove Pdfium packages
dotnet remove package Pdfium.NET
dotnet remove package Pdfium.Net.SDK
dotnet remove package PdfiumViewer

# Install IronPDF
dotnet add package IronPdf

Lizenz-Konfiguration

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

Pdfium-Verwendung identifizieren

# Find Pdfium usage
grep -r "Pdfium\|PdfDocument\.Load\|\.Render\(" --include="*.cs" .

# Find native binary references
grep -r "pdfium\.dll\|pdfium\.so\|pdfium\.dylib" --include="*.csproj" --include="*.config" .

# Find platform-specific code
grep -r "#if.*64\|WIN32\|WIN64\|LINUX\|OSX" --include="*.cs" .

# Find Pdfium usage
grep -r "Pdfium\|PdfDocument\.Load\|\.Render\(" --include="*.cs" .

# Find native binary references
grep -r "pdfium\.dll\|pdfium\.so\|pdfium\.dylib" --include="*.csproj" --include="*.config" .

# Find platform-specific code
grep -r "#if.*64\|WIN32\|WIN64\|LINUX\|OSX" --include="*.cs" .

Namensraumänderungen

// Pdfium.NET
using Pdfium;
using Pdfium.Net;
using PdfiumViewer;

// IronPDF
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Editing;

// Pdfium.NET
using Pdfium;
using Pdfium.Net;
using PdfiumViewer;

// IronPDF
using IronPdf;
using IronPdf.Rendering;
using IronPdf.Editing;

Kernklassen-Zuordnungen

Zuordnungen beim Laden von Dokumenten

Zuordnungen von Dokumenteigenschaften

Textextraktions-Zuordnungen

Zuordnungen von Dokumenten speichern

Seiten-Rendering-Zuordnungen

Neue Funktionen, die in Pdfium nicht verfügbar sind

Beispiel 1: Textextraktion aus PDF

Vor (Pdfium):

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System;
using System.IO;
using System.Text;

class Program
{
    static void Main()
    {
        string pdfPath = "document.pdf";

        using (var document = PdfDocument.Load(pdfPath))
        {
            StringBuilder text = new StringBuilder();

            for (int i = 0; i < document.PageCount; i++)
            {
                // Note: PdfiumViewer has limited text extraction capabilities
                // Text extraction requires additional work with Pdfium.NET
                string pageText = document.GetPdfText(i);
                text.AppendLine(pageText);
            }

            Console.WriteLine(text.ToString());
        }
    }
}

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System;
using System.IO;
using System.Text;

class Program
{
    static void Main()
    {
        string pdfPath = "document.pdf";

        using (var document = PdfDocument.Load(pdfPath))
        {
            StringBuilder text = new StringBuilder();

            for (int i = 0; i < document.PageCount; i++)
            {
                // Note: PdfiumViewer has limited text extraction capabilities
                // Text extraction requires additional work with Pdfium.NET
                string pageText = document.GetPdfText(i);
                text.AppendLine(pageText);
            }

            Console.WriteLine(text.ToString());
        }
    }
}

Nach (IronPDF):

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

class Program
{
    static void Main()
    {
        string pdfPath = "document.pdf";

        var pdf = PdfDocument.FromFile(pdfPath);
        string text = pdf.ExtractAllText();

        Console.WriteLine(text);
    }
}

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

class Program
{
    static void Main()
    {
        string pdfPath = "document.pdf";

        var pdf = PdfDocument.FromFile(pdfPath);
        string text = pdf.ExtractAllText();

        Console.WriteLine(text);
    }
}

Der Unterschied ist hier signifikant. Pdfium erfordert eine manuelle Schleife durch jede Seite mit GetPdfText(pageIndex), erstellt einen StringBuilder und verwaltet die using Anweisung für die ordnungsgemäße Entsorgung. Der Code weist darauf hin, dass "PdfiumViewer nur begrenzte Möglichkeiten zur Textextraktion hat" und dass "die Textextraktion zusätzliche Arbeit erfordert."

IronPDF vereinfacht dies auf drei Zeilen: laden mit PdfDocument.FromFile(), extrahieren mit ExtractAllText(), und ausgeben. Die ExtractAllText() Methode verarbeitet alle Seiten automatisch mit fortgeschrittenen Textextraktionsfähigkeiten. Wenn Sie eine Textextraktion pro Seite benötigen, können Sie pdf.Pages[index].Text verwenden. Siehe die Dokumentation zur Textextraktion für weitere Optionen.

Beispiel 2: PDF-Zusammenführung

Vor (Pdfium):

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

// Note: PdfiumViewer does not have native PDF merging functionality
// You would need to use additional libraries or implement custom logic
class Program
{
    static void Main()
    {
        List<string> pdfFiles = new List<string> 
        { 
            "document1.pdf", 
            "document2.pdf", 
            "document3.pdf" 
        };

        // PdfiumViewer is primarily for rendering/viewing
        // PDF merging is not natively supported
        // You would need to use another library like iTextSharp or PdfSharp

        Console.WriteLine("PDF merging not natively supported in PdfiumViewer");
    }
}

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

// Note: PdfiumViewer does not have native PDF merging functionality
// You would need to use additional libraries or implement custom logic
class Program
{
    static void Main()
    {
        List<string> pdfFiles = new List<string> 
        { 
            "document1.pdf", 
            "document2.pdf", 
            "document3.pdf" 
        };

        // PdfiumViewer is primarily for rendering/viewing
        // PDF merging is not natively supported
        // You would need to use another library like iTextSharp or PdfSharp

        Console.WriteLine("PDF merging not natively supported in PdfiumViewer");
    }
}

Nach (IronPDF):

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

class Program
{
    static void Main()
    {
        List<string> pdfFiles = new List<string> 
        { 
            "document1.pdf", 
            "document2.pdf", 
            "document3.pdf" 
        };

        var pdf = PdfDocument.Merge(pdfFiles);
        pdf.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()
    {
        List<string> pdfFiles = new List<string> 
        { 
            "document1.pdf", 
            "document2.pdf", 
            "document3.pdf" 
        };

        var pdf = PdfDocument.Merge(pdfFiles);
        pdf.SaveAs("merged.pdf");

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

Dieses Beispiel verdeutlicht eine grundlegende Fähigkeitslücke. Pdfium kann PDFs nicht zusammenführen - im Code heißt es ausdrücklich: "PDF-Zusammenführung wird in PdfiumViewer nicht nativ unterstützt" und "Sie müssten eine andere Bibliothek wie iTextSharp oder PdfSharp verwenden."

IronPDF bietet natives Zusammenführen mit der statischen PdfDocument.Merge() Methode, die eine Liste von Dateipfaden direkt akzeptiert. Das Ergebnis ist ein neues PdfDocument, das Sie mit SaveAs() speichern. Erfahren Sie mehr über das Zusammenführen und Aufteilen von PDFs.

Beispiel 3: Konvertierung von HTML in PDF

Vor (Pdfium):

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System.IO;
using System.Drawing.Printing;

// Note: PdfiumViewer is primarily for viewing/rendering PDFs, not creating them from HTML
// For HTML to PDF with Pdfium.NET, you would need additional libraries
// This example shows a limitation of Pdfium.NET
class Program
{
    static void Main()
    {
        // Pdfium.NET does not have native HTML to PDF conversion
        // You would need to use a separate library to convert HTML to PDF
        // then use Pdfium for manipulation
        string htmlContent = "<h1>Hello World</h1>";

        // This functionality is not directly available in Pdfium.NET
        Console.WriteLine("HTML to PDF conversion not natively supported in Pdfium.NET");
    }
}

// NuGet: Install-Package PdfiumViewer
using PdfiumViewer;
using System.IO;
using System.Drawing.Printing;

// Note: PdfiumViewer is primarily for viewing/rendering PDFs, not creating them from HTML
// For HTML to PDF with Pdfium.NET, you would need additional libraries
// This example shows a limitation of Pdfium.NET
class Program
{
    static void Main()
    {
        // Pdfium.NET does not have native HTML to PDF conversion
        // You would need to use a separate library to convert HTML to PDF
        // then use Pdfium for manipulation
        string htmlContent = "<h1>Hello World</h1>";

        // This functionality is not directly available in Pdfium.NET
        Console.WriteLine("HTML to PDF conversion not natively supported in Pdfium.NET");
    }
}

Nach (IronPDF):

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        string htmlContent = "<h1>Hello World</h1>";

        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        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();
        string htmlContent = "<h1>Hello World</h1>";

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

        Console.WriteLine("PDF created successfully");
    }
}

Dieses Beispiel verdeutlicht den größten Unterschied in den Fähigkeiten. Pdfium weist ausdrücklich darauf hin, dass die Konvertierung von HTML in PDF in Pdfium.NET nicht nativ unterstützt wird und dass Sie eine separate Bibliothek verwenden müssen, um HTML in PDF zu konvertieren

IronPDF bietet native HTML-zu-PDF-Konversion durch ChromePdfRenderer, das intern eine Chromium-Engine für präzises Rendern von HTML, CSS und JavaScript verwendet. Die RenderHtmlAsPdf() Methode konvertiert HTML-Strings direkt in PDF-Dokumente.IronPDFkann auch URLs mit RenderUrlAsPdf() und HTML-Dateien mit RenderHtmlFileAsPdf() rendern. Umfassende Beispiele finden Sie in der HTML to PDF Dokumentation.

Vor (Pdfium) - Komplexe Bereitstellung

MyApp/
├── bin/
│ ├── MyApp.dll
│ ├── Pdfium.NET.dll
│ ├── x86/
│ │ └── pdfium.dll
│ └── x64/
│ └── pdfium.dll
├── runtimes/
│ ├── win-x86/native/
│ │ └── pdfium.dll
│ └── win-x64/native/
│ └── pdfium.dll

Nach (IronPDF) - Saubere Bereitstellung

MyApp/
├── bin/
│ ├── MyApp.dll
│ └── IronPDF.dll # Alles enthalten

Native binäre Referenzen entfernen

# Delete native PDFium binaries
rm -rf x86/ x64/ runtimes/

# Remove from .csproj
# Delete any <Content Include="pdfium.dll" /> entries
# Delete any <None Include="x86/pdfium.dll" /> entries

# Delete native PDFium binaries
rm -rf x86/ x64/ runtimes/

# Remove from .csproj
# Delete any <Content Include="pdfium.dll" /> entries
# Delete any <None Include="x86/pdfium.dll" /> entries

Umwandlung von Skala in DPI

Pdfium verwendet Skalierungsfaktoren;IronPDFverwendet DPI:

// Formula:IronPDFDPI = 72 × Pdfium scale
// Pdfium scale 2.0 →IronPDFDPI 144
pdf.RasterizeToImageFiles("*.png", DPI: 144);

// Formula:IronPDFDPI = 72 × Pdfium scale
// Pdfium scale 2.0 →IronPDFDPI 144
pdf.RasterizeToImageFiles("*.png", DPI: 144);

Änderung der Methode zum Laden von Dokumenten

// Pdfium
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

// Pdfium
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

Methodenänderung speichern

// Pdfium
document.Save(path)

// IronPDF
pdf.SaveAs(path)

// Pdfium
document.Save(path)

// IronPDF
pdf.SaveAs(path)

Vereinfachung von Entsorgungsmustern

// Pdfium: Erforderlichexplicit disposal
using (var document = PdfDocument.Load(path))
using (var page = document.Pages[0])
using (var bitmap = page.Render(1024, 768))
{
    bitmap.Save("output.png");
}

// IronPDF: Simplified
var pdf = PdfDocument.FromFile(path);
pdf.RasterizeToImageFiles("output.png");

// Pdfium: Erforderlichexplicit disposal
using (var document = PdfDocument.Load(path))
using (var page = document.Pages[0])
using (var bitmap = page.Render(1024, 768))
{
    bitmap.Save("output.png");
}

// IronPDF: Simplified
var pdf = PdfDocument.FromFile(path);
pdf.RasterizeToImageFiles("output.png");

Plattformspezifische Code-Entfernung

// Pdfium: Erforderlichplatform detection
#if WIN64
    // Load x64 pdfium.dll
#else
    // Load x86 pdfium.dll
#endif

// IronPDF: Remove all platform-specific code
// Just use the API directly

// Pdfium: Erforderlichplatform detection
#if WIN64
    // Load x64 pdfium.dll
#else
    // Load x86 pdfium.dll
#endif

// IronPDF: Remove all platform-specific code
// Just use the API directly

Vor der Migration

• Identifizieren Sie alle Pdfium-Verwendungen im Codebase
• Dokumentieren Sie die aktuellen Rendering-Dimensionen/-Skalen
• Listen Sie native Binärstandorte im Projekt auf
• Überprüfen Sie den Plattform-spezifischen Ladecode
• Identifizieren Sie PDF-Erstellungsbedarfe (verwenden Sie derzeit separate Tools?)
• Überprüfen Sie die Entsorgungsmuster für die Konversion
• IronPDF-Lizenzschlüssel erhalten

Paketänderungen

• Entfernen Sie Pdfium.NET, Pdfium.Net.SDK, PdfiumViewer NuGet-Pakete
• Löschen Sie native pdfium.dll Binärdateien aus x86/, x64/, runtimes/ Ordnern
• Entfernen Sie plattform-spezifische bedingte Kompilierung
• Aktualisieren Sie .csproj um native Binärreferenzen zu entfernen
• Installieren Sie IronPdf NuGet-Paket: dotnet add package IronPdf

Code-Änderungen

• Lizenzschlüsselkonfiguration beim Start hinzufügen
• Ersetzen Sie PdfDocument.Load() durch PdfDocument.FromFile()
• Ersetzen Sie document.Save() durch pdf.SaveAs()
• Ersetzen document.GetPdfText(i) Schleifen durch pdf.ExtractAllText()
• Konvertieren Sie Skalierungsfaktoren in DPI-Werte (DPI = 72 × Skala)
• Vereinfachen Sie Entsorgungsmuster (entfernen Sie verschachtelte using-Anweisungen)
• Entfernen Sie plattform-spezifischen Code

Nach der Migration

• Testen Sie die Renderqualität des Outputs
• Vergleichen Sie die Ergebnisse der Textextraktion
• Testen Sie die plattformübergreifende Bereitstellung
• Fügen Sie neue Funktionen hinzu (HTML zu PDF, Zusammenführung, Wasserzeichen, Sicherheit)
• Dokumentation aktualisieren