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: PDFs können nicht aus HTML, Bildern oder programmatisch erstellt werden. Die Fähigkeiten von Pdfium beschränken sich auf das Anzeigen und Rendern von PDFs.

2. Keine PDF-Manipulation: PDF-Inhalte dürfen nicht zusammengeführt, geteilt oder verändert werden. 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 plattformspezifische 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. Komplexität der Bereitstellung: Muss native DLLs pro Plattform mit x86-, x64- und Laufzeitordnern bündeln und verwalten.

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

6. Kein HTML zu PDF: Webinhalte können nicht in PDF konvertiert werden. Die Konvertierung von HTML in PDF wird in Pdfium.NET nicht nativ unterstützt.

7. Keine Kopf-/Fußzeilen: Es dürfen keine Seitenzahlen oder sich wiederholende Inhalte hinzugefügt werden.

8. Keine Wasserzeichen: Dokumente dürfen nicht mit Overlays versehen werden.

9. Keine Formularunterstützung: PDF-Formulare können nicht ausgefüllt oder gelesen werden.

10. Keine Sicherheitsfunktionen: PDFs können nicht verschlüsselt oder mit einem Passwort geschützt werden.

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 Access: Fähigkeit, NuGet-Pakete zu installieren
3. IronPDF Lizenz: Beziehen 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";

IRON VB CONVERTER ERROR developers@ironsoftware.com

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;

IRON VB CONVERTER ERROR developers@ironsoftware.com

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Der Unterschied ist hier signifikant. Pdfium erfordert eine manuelle Schleife durch jede Seite mit GetPdfText(pageIndex), die Erstellung eines StringBuilders und die Verwaltung der using-Anweisung zur ordnungsgemäßen 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 Methode ExtractAllText() behandelt alle Seiten automatisch mit erweiterten Textextraktionsfunktionen. Wenn Sie eine seitenweise Extraktion benötigen, können Sie pdf.Pages[index].Text verwenden. Weitere Optionen finden Sie in der Textextraktionsdokumentation.

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

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 eine native Zusammenführung mit der statischen Methode PdfDocument.Merge(), 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");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

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-Konvertierung durch den ChromePdfRenderer, der intern eine Chromium-Engine für die genaue Darstellung von HTML, CSS und JavaScript verwendet. Die Methode RenderHtmlAsPdf() wandelt HTML-Strings direkt in PDF-Dokumente um.IronPDFkann auch URLs mit RenderUrlAsPdf() und HTML-Dateien mit RenderHtmlFileAsPdf() darstellen. 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);

IRON VB CONVERTER ERROR developers@ironsoftware.com

Änderung der Methode zum Laden von Dokumenten

// Pdfium
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

// Pdfium
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

IRON VB CONVERTER ERROR developers@ironsoftware.com

Methodenänderung speichern

// Pdfium
document.Save(path)

// IronPDF
pdf.SaveAs(path)

// Pdfium
document.Save(path)

// IronPDF
pdf.SaveAs(path)

IRON VB CONVERTER ERROR developers@ironsoftware.com

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Vor der Migration

• [Identifizieren Sie alle Pdfium-Verwendung in der Codebasis
• [Dokumentieren Sie die aktuell verwendeten Rendering-Maße/Skalen
• [Native Binärpositionen im Projekt auflisten
• [Überprüfung auf plattformspezifischen Ladecode
• [Ermitteln Sie den Bedarf für die PDF-Erstellung (verwenden Sie derzeit separate Tools?)
• [Überprüfung der Entsorgungsmuster für die Konvertierung
• [IronPDF-Lizenzschlüssel erhalten

Paketänderungen

• [Entfernen Sie Pdfium.NET, Pdfium.Net.SDK, PdfiumViewer NuGet-Pakete
• [Native pdfium.dll-Binärdateien aus den Ordnern x86/, x64/, runtimes/ löschen
• [Plattformspezifische bedingte Kompilierung entfernen
• [.csproj aktualisieren, um native Binärreferenzen zu entfernen
• [Installieren Sie das NuGet-Paket IronPdf: dotnet add package IronPdf

Code-Änderungen

• [Lizenzschlüsselkonfiguration beim Starten hinzufügen
• [Ersetzen Sie PdfDocument.Load() mit PdfDocument.FromFile()
• [Ersetzen Sie document.Save() mit pdf.SaveAs()
• [Ersetzen Sie document.GetPdfText(i)-Schleifen durch pdf.ExtractAllText()
• [Skalenfaktoren in DPI-Werte umrechnen (DPI = 72 × Skala)
• [Entsorgungsmuster vereinfachen (verschachtelte using-Anweisungen entfernen)
• [Plattformspezifischen Code entfernen

Post-Migration

• [Testen Sie die Qualität der Rendering-Ausgabe
• [Ergebnisse der Textextraktion vergleichen
• [Testen Sie die plattformübergreifende Bereitstellung
• [Neue Funktionen hinzufügen (HTML zu PDF, Zusammenführen, Wasserzeichen, Sicherheit)
• [Dokumentation aktualisieren