How to Migrate from Pdfium to IronPDF in C#

了解 Pdfium.NET

Pdfium.NET 是 Google PDFium 庫的 .NET 封裝庫，以其在渲染 PDF 文件方面的效率和速度而聞名。 它已成為開發人員深入研究 C# 應用程式中 PDF 渲染細節的重要程式庫，可在 .NET 環境中提供 PDF 內容的高保真複製。

然而，儘管 Pdfium.NET 在渲染方面表現出色，但它在建立和操作 PDF 文件方面的功能卻很有限。 它主要面向那些需要精確顯示 PDF 內容，而不太注重修改或建立新 PDF 的應用程式場景。

鈀的關鍵限制

1.僅渲染焦點：無法從 HTML、圖像或以程式設計方式建立 PDF。 Pdfium 的功能僅限於檢視和渲染 PDF 檔案。

2.不支援 PDF 操作：無法合併、拆分或修改 PDF 內容。 PDF 合併功能目前不支援，您需要使用 iTextSharp 或 PdfSharp 等其他函式庫。

3.本地二進位依賴項：需要特定於平台的 PDFium 二進位。 開發人員需要管理原生 PDFium 二進位文件，這增加了部署和分發過程中的複雜性。

4.部署複雜性：必須將每個平台的本機 DLL 打包和管理，並包含 x86、x64 和運行時資料夾。

5.有限文字擷取：基本文字擷取，不進行格式化。 文本提取需要使用 Pdfium.NET 進行額外操作。

6.不支援 HTML 轉 PDF：無法將網頁內容轉換為 PDF。 Pdfium.NET 本身並不支援 HTML 到 PDF 的轉換。

7.無頁首/頁尾：無法新增頁碼或重複內容。

8.無浮水印：無法在有疊加層的文件上加蓋水印。

9.不支援表單：無法填寫或讀取 PDF 表單。

10.無安全功能：無法加密或密碼保護 PDF 檔案。

鈀與IronPDF比較

對於計劃在 2025 年和 2026 年採用 .NET 10 和 C# 14 的團隊，IronPDF 提供了一個完全託管的基礎，消除了原生二進位管理，同時增加了全面的 PDF 創建和操作功能。

先決條件

1. .NET 環境： .NET Framework 4.6.2+ 或 .NET Core 3.1+ / .NET 5/6/7/8/9+
2. NuGet 存取權限：能夠安裝 NuGet 套件
3. IronPDF 許可證：請從ironpdf.com取得您的許可證密鑰。

NuGet 套件變更

# 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

許可證配置

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

確定鈀的使用情況

# 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" .

命名空間變更

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

核心類別映射

文件載入映射

文檔屬性映射

文字擷取映射

儲存文件映射

頁面渲染映射

Pdfium 中不提供新功能

範例 1：從 PDF 中提取文本

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

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

這裡的差異非常顯著。 Pdfium 需要手動遍歷每一頁，使用GetPdfText(pageIndex)建立StringBuilder並管理using語句以進行正確處置。 程式碼指出"PdfiumViewer 的文本提取功能有限"，並且"文本提取需要額外的工作"。

IronPDF 將此操作簡化為三行程式碼：使用PdfDocument.FromFile()加載，使用ExtractAllText()提取，然後輸出。 ExtractAllText()方法具有更進階的文字擷取功能，可自動處理所有頁面。 如果需要逐頁擷取，可以使用pdf.Pages[index].Text 。 有關其他選項，請參閱文字擷取文件。

範例 2：PDF 合併

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

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

這個例子凸顯了一個根本性的功能缺陷。 Pdfium 無法合併 PDF 文件——程式碼明確指出"PdfiumViewer 本身不支援 PDF 合併"，並且"您需要使用其他庫，例如 iTextSharp 或 PdfSharp"。

IronPDF 提供原生合併功能，其靜態方法PdfDocument.Merge()可直接接受檔案路徑清單。 結果是一個新的PdfDocument ，您可以使用SaveAs()將其儲存。 了解更多關於合併和拆分PDF的資訊。

範例 3：HTML 轉 PDF

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

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

這個例子反映了能力上最顯著的差異。 Pdfium 明確指出"Pdfium.NET 本身不支援 HTML 到 PDF 的轉換"，並且"您需要使用單獨的庫將 HTML 轉換為 PDF"。

IronPDF 透過ChromePdfRenderer提供原生 HTML 到 PDF 的轉換，該渲染器內部使用 Chromium 引擎來精確渲染 HTML、CSS 和 JavaScript。 RenderHtmlAsPdf()方法直接將 HTML 字串轉換為 PDF 文件。 IronPDF 也可以使用RenderUrlAsPdf()渲染 URL，使用RenderHtmlFileAsPdf()渲染 HTML 檔案。 請參閱HTML 轉 PDF 文件以取得完整範例。

之前（Pdfium）- 複雜部署

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

（IronPDF）之後 - 乾淨部署

MyApp/
├── bin/
│ ├── MyApp.dll
│ └── IronPdf.dll # 包含所有內容

移除本地二進位引用

# 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

縮放比例到 DPI 的轉換

Pdfium 使用比例因子； IronPDF 使用 DPI：

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

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

文件載入方式變更

// Pdfium
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

// Pdfium
PdfDocument.Load(path)

// IronPDF
PdfDocument.FromFile(path)

儲存方法更改

// Pdfium
document.Save(path)

// IronPDF
pdf.SaveAs(path)

// Pdfium
document.Save(path)

// IronPDF
pdf.SaveAs(path)

處置模式簡化

// Pdfium: 必需的 explicit 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: 必需的 explicit 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: 必需的 platform 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: 必需的 platform 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 的使用情況
• 記錄目前使用的渲染尺寸/比例
• 列出專案中的本機二進位位置
• 檢查平台特定的載入程式碼
• 確定PDF創建需求（目前是否使用不同的工具？）
• 審查轉換處置模式
• 取得 IronPDF 許可證密鑰

軟體包變更

• 移除Pdfium.NET 、 Pdfium.Net.SDK和PdfiumViewer NuGet 套件
• 從 x86/、x64/ 和 runtimes/ 資料夾中刪除本機 pdfium.dll 二進位文件
• 移除平台特定的條件編譯
• 更新 .csproj 檔案以移除原生二進位引用 安裝IronPdf NuGet 套件： dotnet add package IronPdf

程式碼更改

• 在啟動時新增許可證金鑰配置
• 將PdfDocument.Load()替換為PdfDocument.FromFile()
• 將document.Save()替換為pdf.SaveAs()
• 將document.GetPdfText(i)循環替換為pdf.ExtractAllText()
• 將比例因子轉換為 DPI 值（DPI = 72 × 比例）
• 簡化資源釋放模式（移除巢狀的 using 語句）
• 刪除平台特定程式碼

移民後

• 測試渲染輸出質量
• 比較文字擷取結果
• 測試跨平台部署
• 新增功能（HTML 轉 PDF、合併、浮水印、安全）
• 更新文檔