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

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

ops 2025/9/7 8:22:46

在现代软件开发中，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 文件，提升开发效率。如果你在使用过程中遇到问题，欢迎随时向我提问！

http://www.xdnf.cn/news/4598.html

相关文章：

  • 贵州安全员考试内容有哪些？
  • Python学习笔记--Django的安装和简单使用(一)
  • 【Linux网络】Socket 编程预备
  • 图像管理与人脸识别工具深度解析
  • 查看单元测试覆盖率
  • 辰鳗科技朱越洋：紧扣时代契机，全力投身能源转型战略赛道
  • maven 安装 本地 jar
  • 算法的时间复杂度
  • 手写 vue 源码 ===：自定义调度器、递归调用规避与深度代理
  • 基于大模型预测的产钳助产分娩全方位研究报告
  • 【工具教程】批量提取PDF指定内容并重命名，PDF文档根据指定识别文字改名，基于java的实现方案
  • （7）Nokov 室内光学跟踪系统
  • 玄机 第一章 应急响应-Linux日志分析
  • C#学习7_面向对象：类、方法、修饰符
  • MySQL 8.0 OCP（1Z0-908）英文题库(11-20)
  • 编写大模型Prompt提示词方法
  • 奥威BI：AI+BI深度融合，重塑智能AI数据分析新标杆
  • 382_C++_在用户会话结束时，检查是否有其他会话仍然来自同一个客户端 IP 地址，没有连接状态设置为断开，否则为连接
  • M0芯片的基础篇Timer
  • Android RecyclerView自带的OnFlingListener，Kotlin
  • 58.[前端开发-前端工程化]Day05-webpack-Git安装-配置-Git命令
  • 【目标检测标签转换工具】YOLO 格式与 Pascal VOC XML 格式的互转详解（含完整代码）
  • Tcp 通信简单demo思路
  • Typora安装使用教程，图片相对储存路径路径设置
  • 什么是 DDoS 攻击？从零到精通的全面解析
  • 如何在 Java 中调用本机摄像头并结合 Vue 实现实时视频流？
  • 初识Linux · TCP基本使用 · 回显服务器
  • 矢量网络分析仪测驻波比：从原理到实战操作全解析
  • 101alpha_第6个
  • 自定义Widget开发：复杂组件设计