在现代软件开发中，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 包管理器或者命令行进行安装。
安装命令
-
NuGet 包管理器控制台：
Install-Package Pdfium.Net -
.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 的基本使用，并可以将其应用到实际项目中，提升开发效率和用户体验。
)
的ConvergenceWarning问题解决)
