iTextSharp入门

### iTextSharp 入门详解 #### 一、iTextSharp 概述 iTextSharp 是一款基于 C# 的开源库，它源自 Java 平台的 iText 项目，专门用于生成、操作 PDF 文件。相较于其他同类产品，iTextSharp 因其强大的功能和广泛的使用而脱颖而出，并且作为开源项目，它可以免费用于商业用途，降低了开发成本。 #### 二、iTextSharp 特点 1. **功能强大**：iTextSharp 提供了丰富的 API 接口，支持 PDF 文件的创建、编辑、合并、分割等多种操作。 2. **广泛的社区支持**：由于其开源特性，iTextSharp 拥有一个活跃的开发者社区，提供了大量的示例代码和技术支持。 3. **跨平台性**：虽然起源于 Java 平台，但 iTextSharp 在 .NET 平台上也表现良好，可以在 Windows、Linux 和 macOS 等多种操作系统上运行。 4. **灵活度高**：用户可以根据需求定制 PDF 的各种属性，如页面尺寸、方向、边距等。 #### 三、环境搭建 - **硬件需求**：PC 机。 - **软件需求**： - Windows 操作系统。 - Visual Studio 2013 或以上版本。 - .Net Framework 4.5 或以上版本。 - iTextSharp 5.5 版本库。 iTextSharp 可以通过官网下载，下载后会得到 `iTextSharp.dll` 文件。将此文件添加到项目引用中即可开始使用。 #### 四、基本知识 ##### 4.1 Document 对象 `Document` 对象主要用于控制 PDF 页面的尺寸和方向。可以通过设置不同的参数来自定义页面的尺寸，例如使用预设的标准尺寸 `PageSize.A4` 创建 A4 大小的页面： ```csharp Document document = new Document(PageSize.A4); ``` 为了实现横向页面布局，可以使用 `SetPageSize` 方法并传入旋转后的尺寸： ```csharp document.SetPageSize(new iTextSharp.text.Rectangle(iTextSharp.text.PageSize.A4.Rotate())); ``` 此外，还可以自定义页面尺寸和背景颜色： ```csharp Rectangle pageSize = new Rectangle(120, 520); // 自定义尺寸 pageSize.BackgroundColor = new Color(0xFF, 0xFF, 0xDE); // 设置背景颜色 Document document = new Document(pageSize); ``` 页面边距也可以自定义： ```csharp Document document = new Document(PageSize.A5, 36, 72, 108, 180); // 上、右、下、左边距 ``` ##### 4.2 PdfWriter 对象 `PdfWriter` 对象负责将 `Document` 对象写入到实际的 PDF 文件中。创建 `PdfWriter` 实例通常需要传入 `Document` 对象和输出文件的流： ```csharp string strFileName = "output.pdf"; PdfWriter writer = PdfWriter.GetInstance(document, new FileStream(strFileName, FileMode.Create)); ``` 这里 `FileMode.Create` 表示如果目标文件不存在则创建，如果已存在则覆盖。其他可用模式包括 `FileMode.New`（新建文件）和 `FileMode.Append`（追加内容）。 ##### 4.3 PdfPTable 对象 `PdfPTable` 对象用于在 PDF 中创建表格。可以自定义表格的各种属性，例如标题样式、字体颜色等。以下是一个创建表格的示例方法签名： ```csharp public static void CreatePdfPTable(List<sdr_Context> list, string title, string fontpath_Title, int fontsize_Title, int fontStyle_Title, Color fontColor_Title, string fontpath_Col, int fontsize_Col, int fontStyle_Col, Color fontColor_Col, float col_Width, float[] arr_Width, string pdf_Filename, string FontPath) { // 创建表格代码... } ``` 通过以上介绍，我们可以看到 iTextSharp 为创建和操作 PDF 文件提供了一个强大而灵活的工具包。无论是简单的文档生成还是复杂的表格布局，都能通过 iTextSharp 完成。接下来，可以进一步探索 iTextSharp 的其他高级功能，如图像插入、水印添加等，以满足更多应用场景的需求。