当前位置：首页 > news >正文

全面解析 iTextSharp：在 .NET 中高效处理 PDF

news 来源：原创 2025/5/9 6:16:44

在现代软件开发中，PDF（便携式文档格式）作为一种稳定、跨平台且易于共享的文件格式，广泛应用于报告、发票、合同、电子书籍等多个领域。随着信息化程度的提高，很多系统需要生成、修改或读取 PDF 文件。iTextSharp 是一个非常强大的开源 PDF 操作库，专为 .NET 平台设计，支持生成 PDF 文件、修改现有 PDF、提取 PDF 内容、设置安全性等多种功能。本文将详细解析 iTextSharp，帮助开发者在 .NET 项目中高效处理 PDF 文件。

什么是 iTextSharp？

iTextSharp 是 iText 库的 .NET 版本。iText 是一个开源的 PDF 操作库，最初为 Java 开发，后来移植到了 .NET 平台，形成了 iTextSharp。它为开发者提供了强大的 PDF 文件处理功能，包括：

创建新的 PDF 文件
修改现有的 PDF 文件
提取 PDF 文件中的文本和图像
在 PDF 文件中嵌入表单字段、按钮等交互元素
设置 PDF 文件的密码保护和权限
添加水印、页眉、页脚等内容

iTextSharp 不仅仅限于简单的 PDF 生成，它还能处理复杂的布局、表单处理、文件加密等任务，极大地提高了开发者处理 PDF 文件的效率。

安装 iTextSharp

在 .NET 项目中使用 iTextSharp，首先需要安装该库。你可以通过 NuGet 包管理器进行安装。对于 iTextSharp 的较新版本（iText 7）：

Install-Package itext7

如果你需要使用旧版本的 iTextSharp，可以通过以下命令安装：

Install-Package itextsharp

安装完成后，即可开始在项目中使用 iTextSharp 提供的 API。

基本用法

1. 创建 PDF 文件

iTextSharp 最基本的功能之一是生成 PDF 文件。以下是一个简单的示例，展示如何创建一个包含文本的 PDF 文件：

using iTextSharp.text;
using iTextSharp.text.pdf;
using System.IO;public class CreatePdfExample
{public static void Main(){// 创建一个文档对象Document document = new Document();// 创建一个 PdfWriter 实例，绑定到文件流PdfWriter.GetInstance(document, new FileStream("output.pdf", FileMode.Create));// 打开文档准备写入内容document.Open();// 向文档添加内容document.Add(new Paragraph("Hello, this is a simple PDF document!"));// 关闭文档，保存 PDF 文件document.Close();}
}

在这个示例中，我们创建了一个 Document 对象，并通过 PdfWriter.GetInstance() 方法将其与一个输出文件流绑定。接着，我们向文档中添加了一段简单的文本，最后关闭文档并保存为 PDF 文件。

2. 添加段落和表格

iTextSharp 允许开发者向 PDF 文件中添加更复杂的布局元素，如表格和段落。例如，以下是添加段落和表格的代码示例：

添加段落：

document.Add(new Paragraph("This is a new paragraph"));

添加表格：

PdfPTable table = new PdfPTable(3); // 创建一个三列的表格
table.AddCell("Column 1");
table.AddCell("Column 2");
table.AddCell("Column 3");document.Add(table);

在这个示例中，我们创建了一个三列的表格，并为每一列添加了单元格，最终将表格添加到 PDF 文档中。

3. 设置字体样式

iTextSharp 提供了丰富的字体控制功能，允许开发者自定义字体类型、大小、颜色等。以下是如何设置字体样式的示例：

BaseFont baseFont = BaseFont.CreateFont(BaseFont.HELVETICA_BOLD, BaseFont.CP1252, false);
Font font = new Font(baseFont, 12);
document.Add(new Paragraph("This is a bold paragraph", font));

在这个示例中，我们通过 BaseFont.CreateFont() 方法创建了一个 Helvetica 粗体字体，并设置其大小为 12。然后，使用该字体创建了一个 Font 对象，并将其应用到段落中。

4. 向 PDF 添加图片

除了文本，iTextSharp 还支持将图片嵌入 PDF 文件中。以下是如何插入图片的示例：

Image img = Image.GetInstance("path_to_image.jpg");
document.Add(img);

通过 Image.GetInstance() 方法加载图片并将其添加到 PDF 文档中。

5. 使用表单字段

iTextSharp 支持在 PDF 文件中创建表单字段，用户可以在 PDF 中填写数据。以下是如何创建文本输入框的示例：

PdfWriter writer = PdfWriter.GetInstance(document, new FileStream("form.pdf", FileMode.Create));
document.Open();TextField textField = new TextField(writer, new Rectangle(100, 750, 200, 770), "name");
textField.Text = "Enter your name";
writer.AddAnnotation(textField.GetTextField());document.Close();

此代码段创建了一个名为 name 的文本输入框，并设置了其初始文本内容。

6. 修改已有的 PDF 文件

iTextSharp 还允许修改现有的 PDF 文件。例如，我们可以在已有 PDF 文件上添加新的内容。以下是如何修改现有 PDF 文件的示例：

PdfReader reader = new PdfReader("input.pdf");
PdfStamper stamper = new PdfStamper(reader, new FileStream("output.pdf", FileMode.Create));PdfContentByte canvas = stamper.GetOverContent(1); // 获取第一页
ColumnText.ShowTextAligned(canvas, Element.ALIGN_LEFT, new Phrase("New Text"), 100, 100, 0);stamper.Close();
reader.Close();

在这个示例中，我们使用 PdfReader 加载现有的 PDF 文件，通过 PdfStamper 对其进行修改，最后保存为新的 PDF 文件。

7. 添加水印

为 PDF 文件添加水印是 iTextSharp 另一项常见功能。以下是如何在 PDF 中添加水印的示例：

PdfReader reader = new PdfReader("input.pdf");
PdfStamper stamper = new PdfStamper(reader, new FileStream("output_with_watermark.pdf", FileMode.Create));PdfContentByte canvas = stamper.GetUnderContent(1); // 获取指定页的内容
BaseFont baseFont = BaseFont.CreateFont(BaseFont.HELVETICA, BaseFont.CP1252, false);
Font font = new Font(baseFont, 50, Font.NORMAL, BaseColor.GRAY);canvas.BeginText();
canvas.SetFontAndSize(baseFont, 50);
canvas.SetTextMatrix(100, 500); // 设置水印的位置
canvas.ShowText("WATERMARK");
canvas.EndText();stamper.Close();
reader.Close();

在这个示例中，我们为 PDF 文件的第一页添加了一个水印。水印使用 50 号字体，并设置为灰色。

8. 读取 PDF 内容

iTextSharp 还支持从 PDF 文件中提取文本内容。以下是如何提取 PDF 内容的示例：

PdfReader reader = new PdfReader("input.pdf");
StringBuilder text = new StringBuilder();for (int i = 1; i <= reader.NumberOfPages; i++)
{text.Append(PdfTextExtractor.GetTextFromPage(reader, i));
}Console.WriteLine(text.ToString());
reader.Close();

此代码将从 PDF 文件中提取所有页的文本内容，并打印输出。

9. 设置 PDF 权限和密码保护

iTextSharp 还允许为 PDF 文件设置密码保护和权限控制。以下是如何设置用户密码和拥有者密码的示例：

PdfReader reader = new PdfReader("input.pdf");
PdfStamper stamper = new PdfStamper(reader, new FileStream("protected_output.pdf", FileMode.Create));
stamper.SetEncryption(PdfWriter.STRENGTH128BITS, "userpassword", "ownerpassword", PdfWriter.AllowPrinting);stamper.Close();
reader.Close();

通过这个方法，我们为 PDF 文件设置了用户密码和拥有者密码，并允许用户打印文件。

总结

iTextSharp 是一个功能强大的 PDF 操作库，适用于 .NET 环境。无论是简单的 PDF 文件生成，还是复杂的内容修改、表单填充、文件加密，iTextSharp 都能提供强大的支持。本文详细介绍了 iTextSharp 的基本用法，涵盖了从创建、修改、提取 PDF 内容到设置权限等多个方面的功能。希望这些示例能够帮助开发者高效地处理 PDF 文件，提升开发效率。如果你在使用过程中遇到问题，欢迎随时向我提问！