在現代軟件開發中，PDF 文件的處理變得愈加重要，尤其是在文檔管理、報表生成和在線內容展示等領域。為了高效地處理和渲染 PDF 文件，開發者通常會選擇一些強大的 PDF 處理庫。而 Pdfium.Net，作為 PDFium 庫的 .NET 封裝，提供了一個高效且易于使用的解決方案，能夠幫助開發者在 .NET 環境中輕松地處理和渲染 PDF 文件。

本文將詳細介紹如何在 .NET 中使用 Pdfium.Net 進行 PDF 文件渲染、文本提取、頁面處理等常見操作，幫助你理解如何利用該庫進行高效的 PDF 處理。

---

一、什么是 Pdfium.Net？

Pdfium.Net 是 Google 開源的 PDFium 引擎的 .NET 封裝。PDFium 是一個高效的 PDF 渲染引擎，廣泛應用于瀏覽器和 PDF 查看器中，特別擅長處理 PDF 渲染和顯示。通過 Pdfium.Net，開發者可以在 .NET 環境下方便地使用 PDFium 來渲染、查看和處理 PDF 文件。

主要特點

• 高效的 PDF 渲染：支持將 PDF 文件頁面渲染為圖像，便于查看和展示。

• 文本提取：可以從 PDF 文件中提取文本內容。

• 簡單的 API：提供簡潔的 API，易于集成到 .NET 應用程序中。

• 跨平臺支持：雖然是 .NET 封裝，但可以在 Windows 環境下運行，支持多種平臺。

---

二、如何安裝 Pdfium.Net

要在 .NET 項目中使用 Pdfium.Net，你首先需要通過 NuGet 安裝該庫。可以通過 NuGet 包管理器或者命令行進行安裝。

安裝命令

1. NuGet 包管理器控制臺：

   Install-Package Pdfium.Net
   

2. .NET CLI：

   dotnet add package Pdfium.Net
   

安裝完成后，你可以在代碼中引用 PdfiumViewer 命名空間，從而使用 Pdfium.Net 提供的功能。

using PdfiumViewer;

---

三、Pdfium.Net 的基本使用

Pdfium.Net 提供了多種功能，下面我們將介紹一些最常見的使用場景，例如渲染 PDF 頁面為圖像、提取文本內容等。

1. 渲染 PDF 頁面為圖像

Pdfium.Net 主要用于將 PDF 頁面渲染為圖像，這使得它非常適合用于在應用程序中顯示 PDF 文件的內容。通過將 PDF 頁面渲染為圖像，你可以將其展示在任何圖形控件中，如 Windows Forms 的 PictureBox 或 WPF 的 Image 控件。

代碼示例：渲染 PDF 頁面為圖像

using PdfiumViewer;
using System.Drawing;public void RenderPdfPageToImage(string pdfFilePath, int pageNumber, string outputImagePath)
{using (var document = new PdfDocument(pdfFilePath)){var page = document.Pages[pageNumber];  // 獲取指定頁面var bitmap = page.Render();  // 渲染頁面為圖像bitmap.Save(outputImagePath, System.Drawing.Imaging.ImageFormat.Png);  // 保存為 PNG 格式}
}

通過上述代碼，你可以渲染指定頁并將其保存為圖像文件，方便在界面中顯示。

2. 在 Windows Forms 中顯示 PDF 頁面

在 Windows Forms 應用程序中，你可以將渲染的 PDF 頁面圖像直接顯示在 PictureBox 控件中。

代碼示例：顯示 PDF 頁面

using PdfiumViewer;
using System.Drawing;
using System.Windows.Forms;public void DisplayPdfPageInPictureBox(string pdfFilePath, int pageNumber, PictureBox pictureBox)
{using (var document = new PdfDocument(pdfFilePath)){var page = document.Pages[pageNumber];  // 獲取指定頁面var bitmap = page.Render();  // 渲染頁面為圖像pictureBox.Image = bitmap;  // 顯示渲染的圖像}
}

這段代碼將 PDF 頁面渲染為圖像，并在 Windows Forms 應用程序中的 PictureBox 控件中顯示出來。

3. 獲取 PDF 文件的總頁數

有時你可能需要獲取 PDF 文件的總頁數，Pdfium.Net 提供了簡單的方法來獲取頁面數量。

代碼示例：獲取 PDF 頁數

using PdfiumViewer;public int GetPageCount(string pdfFilePath)
{using (var document = new PdfDocument(pdfFilePath)){return document.PageCount;  // 獲取總頁數}
}

---

四、處理 PDF 頁面：縮放與旋轉

Pdfium.Net 提供了對 PDF 頁面縮放和旋轉的支持，方便開發者根據需求調整頁面的顯示效果。

1. 縮放 PDF 頁面

通過 Render 方法，你可以設置渲染時的縮放因子，從而實現頁面縮放。

代碼示例：縮放 PDF 頁面

using PdfiumViewer;
using System.Drawing;public void RenderPdfPageWithZoom(string pdfFilePath, int pageNumber, float zoomFactor, string outputImagePath)
{using (var document = new PdfDocument(pdfFilePath)){var page = document.Pages[pageNumber];var bitmap = page.Render(zoomFactor);  // 設置縮放因子bitmap.Save(outputImagePath, System.Drawing.Imaging.ImageFormat.Png);  // 保存為 PNG 格式}
}

2. 旋轉 PDF 頁面

你可以對 PDF 頁面進行旋轉操作，以適應不同的顯示需求。

代碼示例：旋轉 PDF 頁面

using PdfiumViewer;
using System.Drawing;public void RotatePdfPage(string pdfFilePath, int pageNumber, float rotationAngle, string outputImagePath)
{using (var document = new PdfDocument(pdfFilePath)){var page = document.Pages[pageNumber];page.Rotate(rotationAngle);  // 旋轉頁面var bitmap = page.Render();  // 渲染旋轉后的頁面bitmap.Save(outputImagePath, System.Drawing.Imaging.ImageFormat.Png);  // 保存為圖像}
}

通過這段代碼，你可以對 PDF 頁面進行旋轉操作，并將其保存為圖像文件。

---

五、提取 PDF 文本內容

有時，你需要從 PDF 文件中提取文本內容進行處理或分析。Pdfium.Net 允許你輕松地從 PDF 頁面中提取文本。

代碼示例：提取 PDF 文本

using PdfiumViewer;public string ExtractTextFromPage(string pdfFilePath, int pageNumber)
{using (var document = new PdfDocument(pdfFilePath)){var page = document.Pages[pageNumber];return page.GetText();  // 提取頁面文本}
}

這段代碼將提取 PDF 頁面中的文本內容，并以字符串形式返回，便于后續處理。

---

六、Pdfium.Net 在 WPF 中的使用

如果你正在開發 WPF 應用程序，可以通過將渲染的圖像轉換為 BitmapImage 類型，將其顯示在 Image 控件中。

代碼示例：在 WPF 中顯示 PDF 頁面

using PdfiumViewer;
using System.Drawing;
using System.Windows.Controls;
using System.Windows.Media.Imaging;
using System.IO;public void DisplayPdfPageInWPFImageControl(string pdfFilePath, int pageNumber, Image imageControl)
{using (var document = new PdfDocument(pdfFilePath)){var page = document.Pages[pageNumber];var bitmap = page.Render();var memoryStream = new MemoryStream();bitmap.Save(memoryStream, System.Drawing.Imaging.ImageFormat.Png);memoryStream.Seek(0, SeekOrigin.Begin);var bitmapImage = new BitmapImage();bitmapImage.BeginInit();bitmapImage.StreamSource = memoryStream;bitmapImage.CacheOption = BitmapCacheOption.OnLoad;bitmapImage.EndInit();imageControl.Source = bitmapImage;  // 在 WPF Image 控件中顯示圖像}
}

這段代碼將 PDF 頁面渲染為圖像并顯示在 WPF 應用程序的 Image 控件中。

---

七、總結

Pdfium.Net 是一個功能強大的庫，可以幫助 .NET 開發者輕松地處理和渲染 PDF 文件。無論是簡單的頁面渲染，還是文本提取、縮放、旋轉等高級功能，Pdfium.Net 都提供了簡潔而強大的 API。對于需要在桌面應用程序中集成 PDF 查看、顯示和處理功能的開發者來說，Pdfium.Net 是一個非常

值得推薦的工具。通過這篇文章的學習，你已經掌握了 Pdfium.Net 的基本使用，并可以將其應用到實際項目中，提升開發效率和用戶體驗。