iTextSharp中文教程

### iTextSharp中文教程知识点详解 #### 一、iTextSharp简介及应用场景 iTextSharp是一款功能强大的PDF处理库，支持.NET平台。它允许开发者轻松地创建、操作和解析PDF文档，广泛应用于需要生成或编辑PDF文件的企业级应用程序中。 #### 二、创建基本PDF文档 本章节详细介绍了如何使用iTextSharp创建一个简单的PDF文档，具体步骤如下： 1. **创建Document对象**：`Document document = new Document();` - 默认情况下，创建的是一个A4大小的页面，并且具有默认的页边距（36磅）。 - 可以通过传递不同的参数来定制页面尺寸和页边距。 - 使用`Rectangle pageSize`来指定自定义页面尺寸。 - 使用`public Document(Rectangle pageSize, int marginLeft, int marginRight, int marginTop, int marginBottom)`构造函数来自定义页边距。 2. **创建Writer实例**：`PdfWriter.getInstance(document, new FileStream("Chap0101.pdf", FileMode.Create));` - 这一步骤关联了一个`Document`对象与输出流（这里是文件流），以便能够写出PDF文件。 - `PdfWriter`是`DocWriter`的子类，用于生成PDF格式的文档。 3. **打开Document**：`document.Open();` - 在添加任何内容之前，必须先调用`Open()`方法来开启文档。 4. **添加内容**：`document.Add(new Paragraph("Hello World"));` - 通过`Add()`方法向文档中添加内容。这里使用了一个`Paragraph`对象作为示例。 - 如果尝试添加中文内容，默认情况下可能会导致字符无法正常显示的问题。这将在后续章节中解决。 5. **关闭Document**：`document.Close();` - 完成文档的所有操作后，必须调用`Close()`方法来确保所有的资源都被正确释放。 #### 三、自定义页面尺寸和页边距 - **页面尺寸**：可以通过`Rectangle`类来创建自定义大小的页面，例如： ```csharp Rectangle pageSize = new Rectangle(144, 720); // 创建一个细长的页面 pageSize.BackgroundColor = new Color(0xFF, 0xFF, 0xDE); // 设置背景颜色 Document document = new Document(pageSize); ``` - **预设页面尺寸**：iTextSharp提供了多种预设的页面尺寸，包括但不限于A0-A10、LEGAL、LETTER等。 - **旋转页面**：可以使用`rotate()`方法来创建横向页面，例如： ```csharp Document document = new Document(PageSize.A4.rotate()); ``` - **页边距**：可以通过传递额外的页边距参数来自定义文档的页边距，例如： ```csharp Document document = new Document(PageSize.A5, 36, 72, 108, 180); // 分别为上、下、左、右边距 ``` #### 四、度量单位 - 默认度量单位是排版单位磅（point），1英寸=72磅。 - 要创建特定大小的页面或设定页边距，需要转换实际尺寸到磅。例如，A4页面的标准尺寸是210mm×297mm，换算为磅约为595×842磅。 #### 五、Writer实例 - 一旦创建了`Document`对象，就可以创建多个`Writer`实例来操作同一个文档。 - 除了`PdfWriter`外，iTextSharp还提供了其他类型的Writer，例如用于生成TeX文档的`TeXWriter`。 #### 六、后续章节预告 - **第九章**：专门讲解字体问题，解决中文显示等问题。 - 后续章节还将深入探讨更多高级功能，如表格、列表、图片插入等。 通过以上介绍，可以看出iTextSharp为开发者提供了一种简单有效的方式来创建和操作PDF文档。掌握这些基础操作后，可以进一步探索iTextSharp提供的其他高级特性，实现更复杂的应用场景。