.NET的那些事儿(9)——C# 2.0 中用iTextSharp制作PDF（基础篇）

该文主要介绍如何借助iTextSharp在C# 2.0中制作PDF文件，本文的架构大致按照iTextSharp的操作文档进行翻译，如果需要查看原文，请点击一下链接：http://itextsharp.sourceforge.net/tutorial/

一、 iTextSharp的介绍和下载

（1）用户可以浏览官网进行查看：http://itextsharp.sourceforge.net/index.html

iText# (iTextSharp) is a port of the iText open source java library written entirely in C# for the .NET platform. iText# is a library that allows you to generate PDF files on the fly. It is implemented as an assembly.

（2）以下链接用于下载：http://sourceforge.net/project/platformdownload.php?group_id=72954

下载后为一个解压缩文件，用户直接解压后得到一个dll动态链接库，在创建的项目中直接引入即可使用（本文的所有代码均在VS 2005环境下测试通过）

二、创建一个PDF文档(原文：http://itextsharp.sourceforge.net/tutorial/ch01.html）

2.1 示例代码分析

创建一个PDF文档大致包括五个步骤，代码如下：

using System; using System.Collections.Generic; using System.Text; using iTextSharp.text; using iTextSharp.text.pdf; using System.IO; namespace MakePDF { class Program { static void Main(string[] args) { Console.WriteLine("Chapter 1 example 1: Hello World"); // step 1: 创建Document对象 Document document = new Document(); try { //step 2:创建一个writer用于监听Document以及通过PDF-stream指向一个文件 PdfWriter.GetInstance(document, new FileStream("Chap0101.pdf", FileMode.Create)); // step 3: 打开document document.Open(); // step 4: 添加一段话到document中 document.Add(new Paragraph("Hello World PDF")); } catch (DocumentException de) { Console.Error.WriteLine(de.Message); } catch (IOException ioe) { Console.Error.WriteLine(ioe.Message); } // step 5: 关闭document document.Close(); Console.Read(); } } }

该段代码的效果是可以在当前工作目录下，生成一个名字叫做Chap0101.pdf的PDF文档

2.2 第一步：创建Document对象

(1) Document对象

iTextSharp.text.Document有三个构造函数，分别为：

public Document(); public Document(Rectangle pageSize); public Document(Rectangle pageSize, int marginLeft, int marginRight, int marginTop, int marginBottom);

第一个构造函数调用第二个构造函数，参数为PageSize.A4

第二个构造函数调用第三个构造函数，其中每个边距默认值为36

(2) Page Size

你可以创建自己的用于特定颜色的Rectangle对象，并将其作为pageSize。我们对前面的代码进行修改，即创建一个长的、窄的、背景颜色为淡黄色的PDF文档。代码如下：

using System; using System.Collections.Generic; using System.Text; using iTextSharp.text; using iTextSharp.text.pdf; using System.IO; namespace MakePDF { class Program { static void Main(string[] args) { Console.WriteLine("Chapter 1 example 1: Hello World"); // step 1: creation of a document-object Rectangle pageSize = new Rectangle(144, 720); pageSize.BackgroundColor = new Color(0xFF, 0xFF, 0xDE); Document document = new Document(pageSize); //iTextSharp.text.Document document = new Document(); try { // step 2: // we create a writer that listens to the document // and directs a PDF-stream to a file PdfWriter.GetInstance(document, new FileStream("Chap0101.pdf", FileMode.Create)); // step 3: we open the document document.Open(); // step 4: we Add a paragraph to the document document.Add(new Paragraph("Hello World PDF")); } catch (DocumentException de) { Console.Error.WriteLine(de.Message); } catch (IOException ioe) { Console.Error.WriteLine(ioe.Message); } // step 5: we close the document document.Close(); Console.Read(); } } }

大多pageSizes都是采用了PORTRAIT格式，如果你想在LANDSCAPE应用它们，你必须使用rotate(),代码如下：

Document document = new Document(PageSize.A4.rotate());

(3) Margins

在创建document的过程中，你也可以定义左、右、上、下边距，代码如下所示：

Document document = new Document(PageSize.A5, 36, 72, 108, 180);

注意：如果你修改pageSize,会在下一个页面创建时产生影响；如果你修改margins,则会在当前页面立即产生影响。

2.3 创建Write对象

一旦成功创建了document，我们必须创建一个或者多个实例用于监听document,所有的writers继承于iTextSharp.text.DocWriter类。即你可以iTextSharp.text.pdf.PdfWriter 使用来生成PDF文档，而如果需要生成Tex文档你必须使用iTextSharp.text.TeX.TeXWriter。

你可以使用以下的方式创建实例:

PdfWriter writer = PdfWriter.getInstance(document, new FileStream("Chap01xx.pdf"));

在使用过程中，你几乎不会使用到writer对象（除了你想创建高级的PDF文件或者你想使用一些特定的函数，比如ViewerPreferences或者Encryption）,所以获取这类实例就足够了。

该函数的第一个参数即第一步所创建的document对象；

第二个参数为不同类型的Stream对象，目前我们都只使用System.IO.FileStream，后来我们会使用到System.IO.MemoryStream. 

2.4 元数据以及打开document

在你添加实际数据（即内容）是，你可能想加入某些关系到document的元数据，其方法如下：

public boolean addTitle(String title) public boolean addSubject(String subject) public boolean addKeywords(String keywords) public boolean addAuthor(String author) public boolean addCreator(String creator) public boolean addProducer() public boolean addCreationDate() public boolean addHeader(String name, String content)

你可以选择自己的Title,Subject,Keywords,Author以及Creator，但是添加制作者的函数必须一直使用，以及添加创建时间的方法添加的当前系统的时间（事实上，这两个方法是被自动调用的），你可以用客户的姓名作为Header,但是这对于PdfWrite没有任何影响。

2.5 添加内容

1、在前面的三个步骤中，你遇到了诸如：Phrase,Paragraph…的对象，在以后的章节会详细的给予介绍。有些时候，你可能希望writer可以忽略document中的行为，相关的代码可以查看

2、如果你想创建两个writer:writerA和writerB（这个代码在第二步会丢出异常）

PdfWriter writerA = PdfWriter.getInstance(document, new FileStream("Chap0111a.pdf", FileMode.Create)); PdfWriter writerB = PdfWriter.getInstance(document, new FileStream("Chap0111b.pdf", FileMode.Create));

实际上，我们需要对其进行简单的修改，修改后的代码如下：

writerA.Pause(); document.add(new Paragraph("This paragraph will only be added to Chap0111b.pdf, not to Chap0111a.pdf")); writerA.resume();

2.6 关闭document

关闭document相当重要，因为它会影响和关闭writer写的输出流，close方法为finalize方法，但是你不能依靠它，你必须手工对其进行关闭。

三、Chunks, Phrases 和Paragraphs(原文http://itextsharp.sourceforge.net/tutorial/ch02.html)

3.1 Chunk

Chunk是能够添加到document文本中最小的重要部分。Chunk能够为其他的元素诸如Phrase以及Paragrph等构建块，一个Chunk就是一个附有指定字体的字符串，在添加chunk的文本的对象中，所有其他的版面设计参数都应该定义。

下面的代码表示我们创建内容为"Hello world"格式为(red, italic COURIER font of size 20)的Chunk：

Chunk chunk = new Chunk("Hello world", FontFactory.getFont(FontFactory.COURIER, 20, Font.ITALIC, new Color(255, 0, 0)));

 

 

 

3.2 Phrases

Phrases是一系列拥有特定的作为额外参数的leading(=两行之间的空间)的Chunk

Phrases拥有一个主字体，但是其他的chunks可以拥有不同于这个主字体的其余字体，你可以从多种构造函数中创建Phrases对象。代码如下：

using System; using System.IO; using iTextSharp.text; using iTextSharp.text.pdf; public class Chap0202 { public static void Main() { Console.WriteLine("Chapter 2 example 2: Phrases"); // step 1: creation of a document-object Document document = new Document(); try { // step 2: // we create a writer that listens to the document // and directs a PDF-stream to a file PdfWriter.GetInstance(document, new FileStream("Chap0202.pdf", FileMode.Create)); // step 3: we open the document document.Open(); // step 4: we Add a paragraph to the document Phrase phrase0 = new Phrase(); Phrase phrase1 = new Phrase("(1) this is a phrase/n"); // In this example the leading is passed as a parameter Phrase phrase2 = new Phrase(24, "(2) this is a phrase with leading 24. You can only see the difference if the line is long enough. Do you see it? There is more space between this line and the previous one./n"); // When a Font is passed (explicitely or embedded in a chunk), // the default leading = 1.5 * size of the font Phrase phrase3 = new Phrase("(3) this is a phrase with a red, normal font Courier, size 20. As you can see the leading is automatically changed./n", FontFactory.GetFont(FontFactory.COURIER, 20, Font.NORMAL, new Color(255, 0, 0))); Phrase phrase4 = new Phrase(new Chunk("(4) this is a phrase/n")); Phrase phrase5 = new Phrase(18, new Chunk("(5) this is a phrase in Helvetica, bold, red and size 16 with a given leading of 18 points./n", FontFactory.GetFont(FontFactory.HELVETICA, 16, Font.BOLD, new Color(255, 0, 0)))); // A Phrase can contains several chunks with different fonts Phrase phrase6 = new Phrase("(6)"); Chunk chunk = new Chunk(" This is a font: "); phrase6.Add(chunk); phrase6.Add(new Chunk("Helvetica", FontFactory.GetFont(FontFactory.HELVETICA, 12))); phrase6.Add(chunk); phrase6.Add(new Chunk("Times New Roman", FontFactory.GetFont(FontFactory.TIMES_ROMAN, 12))); phrase6.Add(chunk); phrase6.Add(new Chunk("Courier", FontFactory.GetFont(FontFactory.COURIER, 12))); phrase6.Add(chunk); phrase6.Add(new Chunk("Symbol", FontFactory.GetFont(FontFactory.SYMBOL, 12))); phrase6.Add(chunk); phrase6.Add(new Chunk("ZapfDingBats", FontFactory.GetFont(FontFactory.ZAPFDINGBATS, 12))); Phrase phrase7 = new Phrase("(7) if you don't Add a newline yourself, all phrases are glued to eachother!"); document.Add(phrase1); document.Add(phrase2); document.Add(phrase3); document.Add(phrase4); document.Add(phrase5); d