iTextSharp-使用详解

iTextSharp使用详解(转)PDF文件是目前比较流行的电子文档格式，在办公自动化（OA）等软件的开发中，经常要用到该格式，但介绍如何制作PDF格式文件的资料非常少，在网上搜来搜去，都转贴的是同一段“暴力”破解的方法，代码片断如下：StreamWriterpPDF=newStreamWriter(filePath);ArrayListxRefs=newArrayList();floatyPos=0f;longstreamStart=0;longstreamEnd=0;longstreamLen=0;stringstrPDFMessage=null;//PDF文档头信息strPDFMessage=%PDF-1.1\n;ConvertToByteAndAddtoStream(strPDFMessage);xRefs.Add(mPDF.Length);strPDFMessage=10obj\n;ConvertToByteAndAddtoStream(strPDFMessage);strPDFMessage=/Length20R\n;ConvertToByteAndAddtoStream(strPDFMessage);strPDFMessage=stream\n;ConvertToByteAndAddtoStream(strPDFMessage);……看了上面的制作办法，我眼镜都摔坏了三幅，如果用上面这样原始的办法能制作出满意的PDF文件，那一定是天才所为。后来，我从一个网站（网址：）中看到了专门制作PDF文件的控件的介绍，暗喜之余，立马下载试验，果然非常轻松地制作出了想要的PDF文件，因为网站为英文，内容又多，读起来非常费力，在解决了自己的问题后，看到许多网友还在为PDF文件制作而郁闷，遂决定将该内容翻译为中文，由于本人英语水平一般，许多地方又晦涩难懂，故翻译质量不是很满意，敬请斧正，但大部分能看懂。本文的目的一是解决部分网友的燃眉之急，二是抛砖引玉，如果哪位仁兄愿意将该网站中的内容准确翻译出来，则是天下之大幸。要用本文的方法生成PDF文件，需要两个控件：itextsharp.dll和ICSharpCode.SharpZipLib.dll，由于示例代码实在太多，我将代码全部整理出来，放在另外一个文件“示例代码.doc”中，所有这些资源，我均放在了本人的ftp站点（）上的“Pdf文件制作全攻略”文件夹中（文件夹中另外两个rar压缩文件为两个控件的源代码，供大家学习研究使用），你可以到这里下载相应的资源，或者直接到原网站下载。为便于调试和叙述，所有例子均为DOS控制台程序，windows程序使用方法完全一样，按照下面的步骤创建一个可调试的项目：1、打开VS2003；2、单击菜单“文件”→“新建”→“项目”，在项目类型中选择“VisualC#项目”，在模板中选择“控制台应用程序”，输入文件名称如“MakePdf”，指定好存放路径，然后点确定按钮；3、在“解决方案资源管理器”中右键单击“引用”，从弹出的菜单中选择“添加引用”，在“.NET”选项夹中选择“浏览”，添加前面提到的两个应用，如下图：4、在代码窗口顶部添加两个引用：usingiTextSharp.text;usingiTextSharp.text.pdf;至此，准备工作完毕。第一部分iText的简单应用第一章创建一个Document利用iText五步创建一个PDF文件：helloword。第一步，创建一个iTextSharp.text.Document对象的实例：Documentdocument=newDocument();第二步，为该Document创建一个Writer实例：PdfWriter.getInstance(document,newFileStream(Chap0101.pdf,FileMode.Create));第三步，打开当前Documentdocument.Open();第四步，为当前Document添加内容：document.Add(newParagraph(HelloWorld));第五步，关闭Documentdocument.Close();完整的代码见示例代码0101。在例中，不难看出，制作一个PDF文件是非常简单的。注：如果你将例中“document.Add(newParagraph(HelloWorld));”中的字符串“HelloWord”换成中文，如“这是我的第一个PDF文件”，产生的结果一定让你大失所望，因为生成的PDF文件中并没有将中文显示出来，不要担心，在第9章中要专门讲解字体问题，中文显示也就迎刃而解了，如果不能正确显示中文，也就没有必要翻译本文了。下面对这几步做详细介绍。第一步创建一个Document实例：iTextSharp.text.Document-object共有三个构造函数：publicDocument();publicDocument(RectanglepageSize);publicDocument(RectanglepageSize,intmarginLeft,intmarginRight,intmarginTop,intmarginBottom);第一个构造函数以A4页面作为参数调用第二个构造函数，第二个构造函数以每边36磅页边距为参数调用第三个构造函数u页面尺寸：你可以通过指定的颜色和大小创建你自己的页面，示例代码0102创建一个细长的浅黄色背景的页面：RectanglepageSize=newRectangle(144,720);pageSize.BackgroundColor=newColor(0xFF,0xFF,0xDE);Documentdocument=newDocument(pageSize);通常，你不必创建这样的页面，而可以从下面页面尺寸中选择：A0-A10,LEGAL,LETTER,HALFLETTER,_11x17,LEDGER,NOTE,B0-B5,ARCH_A-ARCH_E,FLSA和FLSE大多数情况下使用纵向页面，如果希望使用横向页面，你只须使用rotate()函数：Documentdocument=newDocument(PageSize.A4.rotate());详细代码见示例代码0103。u页边距：当创建一个文件时，你还可以定义上、下、左、右页边距：Documentdocument=newDocument(PageSize.A5,36,72,108,180);在示例代码0104中你可以看到该文档有一个0.5英寸的左边距和1英寸的右边距，上边距为1.5英寸，下边距为2.5英寸。说明：当创建一个矩形或设置边距时，你可能希望知道该用什么度量单位：厘米、英寸或象素，事实上，默认的度量系统以排版单位磅为基础得出其他单位的近似值，如1英寸=72磅，如果你想在A4页面的PDF中创建一个矩形，你需要计算以下数据：21厘米/2.54=8.2677英寸8.2677英寸*72=595磅29.7厘米/2.54=11.6929英寸11.6929英寸*72=842磅默认边距为36磅即半英寸。如果你修改了页面尺寸，仅仅影响到下一页，如果你修改了页边距，则影响到全部，故慎用。关于页面的初始值，请参考第三步。第二步创建Writer实例一旦创建了document，我们可以创建该文档的多个Writer的实例，所有这些Writer实例均继承自抽象类“iTextSharp.text.DocWriter”。同时还有另外一种情况，你可以用iTextSharp.text.pdf.PdfWriter产生文档PDF文件，如果你想创建一个TeX文档，你可以使用iTextSharp.text.TeX.TeXWriter包。Writer类的构造函数是私有的，你只能通过下面的方法创建一个实例：publicstaticxxxWritergetInstance(Documentdocument,Streamos);(xxx是Pdf或Xml)你可以通过下面的方法创建一个实例：PdfWriterwriter=PdfWriter.getInstance(document,newFileStream(Chap01xx.pdf));但是你几乎永远不会用到Writer实例（除非你想创建高级PDF或者希望用一些非常特殊的函数，如ViewerPreferences或Encryption）。所以通过下面的办法得到实例已经足够了：PdfWriter.getInstance(document,newFileStream(Chap01xx.pdf));在第一步中创建一个文档时，第一个参数意义不大，第二个参数可以是任何一种流，到目前为止我们一直使用System.IO.FileStream将Document写入文件中，示例代码0105用到了System.IO.MemoryStream（这不是一个独立的例子，你必须在ServletEngine中测试这些代码。第三步打开Documentu摘要在你写入任何实际数据之前，你可能希望通过以下几种方法写入一些关于本文档的摘要：publicbooleanaddTitle(Stringtitle)publicbooleanaddSubject(Stringsubject)publicbooleanaddKeywords(Stringkeywords)publicbooleanaddAuthor(Stringauthor)publicbooleanaddCreator(Stringcreator)publicbooleanaddProducer()publicbooleanaddCreationDate()publicbooleanaddHeader(Stringname,Stringcontent)你可以选择自己的标题、主题、关键字、作者、创建程序，但以下产品信息将始终被添加：iTextSharp(或者iTextSharp的引用)和创建时间（实际上这两种方法是自动调用的）。你还可以将自定义的名称添加为“报头信息”，但是这对于PdfWriter没有任何作用，如果看看实例代码0101产生的pdf文件的“文档属性”，我们可以看到仅仅有PDF创建程序和产品日期，而示例代码0106的“文档属性”框中有更多的信息。打开document前要做的事：你只能在Open方法调用之前添加摘要，这是iText开发工具提供的一个选择。在HTML中，报头信息被放在文档前面报头标识中间，调用Open方法将导致报头信息写入流，因而在Document被打开后无法更改这些数据。PDF报头信息不包括摘要，看起来有类似于：%PDF-1.2该行显示生成的文档是一个版本为1.2的PDF格式的文件，在PDF中，摘要保存在PdfInfo对象中，当文档关闭时已经写入PdfWriter中了，因此，没有关于为什么不能修改库来满足任何时候添加或更改摘要的技术原因u页面初始化Open方法在不同的Witer中同时会产生初始化事件，举例来说，如果你需要一个水印或者页眉页角对象出现在文档第一页的开始处，你需要在打开文档前添加这些，同样的用于设置该文档其他页水印、页眉、页角、页数和尺寸。当调用下列方法：publicboolsetPageSize(RectanglepageSize)publicboolAdd(Watermarkwatermark)publicvoidremoveWatermark()settingHeaderpropertypublicvoidresetHeader()settingFooterpropertypublicvoidresetFooter()publicvoidresetPageCount()settingPageCountproperty产生的结果只能在下一个新页中看到（当在本页调用初始化方法时），代码见示例代码0107