在这个.NET组件的介绍系列中,受到了很多园友的支持,一些园友(如:数据之巅、 [秦时明月]等等这些大神 )也给我提出了对应的建议,我正在努力去改正,有不足之处还望大家多多包涵。在传播一些简单的知识的同时,我自己也得到了一些提升,这个是我感觉到的最大的益处。知识需要传播,在传播的过程中去让学习的人去提升,在交流中的过程中去让思考的人去展望,我希望我也能在这个传播的过程中出一份力。由于自身能力有限,在编写博文时出现的错误和一些不到位的讲解,还望大家多多见谅。
上面卖完情怀,下面就该切入正题了。
提到打印,恐怕对于很多人都不会陌生,无论是开发者,还是非计算机专业的人员都会接触到打印。对于项目开发中使用到打印的地方会非常多,在.NET项目中,选择打印的方式比较多,例如原始的IE网页打印、水晶报表、JS插件实现打印、导出文档打印,以及今天提到的使用itextSharp组件实现PDF打印等等。
在.NET中实现PDF打印的组件比较多,例如PDFsharp、Report.NET、sharpPDF、itextSharp等等,今天主要简单的介绍itextSharp组件。
一.itextSharp组件概述:
1.iText的是PDF库,它允许你创建,调整,检查和维护的可移植文档格式文件(PDF):
(1).基于从XML文件或数据库中的数据生成文件和报告。
(2).创建地图和书籍,利用众多的互动在PDF可用的功能。
(3).添加书签,页码,水印等功能,以现有的PDF文件。
(4).从现有PDF文件拆分或连接页面;填写交互式表单。
(5).即成动态生成或操纵PDF文档到Web浏览器。
iText所使用的的Java,.NET,Android和GAE开发人员加强与PDF功能的应用程序。iTextSharp的是.NET端口。
2.itextSharp的一些特征:
(1).PDF生成。
(2).PDF操作(冲压水印,合并/拆分PDF文件,...)。
(3).PDF表单填写。
(4).XML功能。
(5).数字签名。
以上是对itextSharp组件的一些特性的简单介绍,如果需要更加深入的了解itextSharp组件的相关信息,可以细致的查看API文档和itextSharp产品介绍。。
二.itextSharp组件核心类和方法:
谈到打印,在我们的项目中需要首先考虑的是我们需要打印的东西是什么。在大脑里面应该首先有一个文档的概念,在我们编程的过程中,“文档”这个词无处不在,这个可以是一个宽泛的概念,也可以是一个狭窄的概念,宽泛的“文档”是指容器,用以存放一些元素;狭窄的“文档”是指实际的文件类型。
对于打印的“文档”,具体看一下宽泛的概念,文档包含元素和节点等等。在组织打印的时候,我们需要创建文档,写入元素和节点等信息,最后组合成为我们需要打印的内容。itextSharp组件可以插入段落、表格、图片等等信息,可以很方便的完成我们需要完成的功能。
Paragraph:报表中的文本;Image:报表中的图片;PdfPTable:表格;PdfPCell:单元格。
1.Document类Open()方法:打开文档对象。
public virtual void Open() { if (!this.close) { this.open = true; } foreach (IDocListener listener in this.listeners) { listener.SetPageSize(this.pageSize); listener.SetMargins(this.marginLeft, this.marginRight, this.marginTop, this.marginBottom); listener.Open(); } }
以上的代码可以看到,我们在打开文档的时候,会设置文档大小,文档页边距等信息。
2.Paragraph类Add()方法:向段落添加元素。
public override bool Add(IElement o) { if (o is List) { List element = (List) o; element.IndentationLeft += this.indentationLeft; element.IndentationRight = this.indentationRight; base.Add(element); return true; } if (o is Image) { base.AddSpecial((Image) o); return true; } if (o is Paragraph) { base.Add(o); IList<Chunk> chunks = this.Chunks; if (chunks.Count > 0) { Chunk chunk = chunks[chunks.Count - 1]; base.Add(new Chunk("\n", chunk.Font)); } else { base.Add(Chunk.NEWLINE); } return true; } base.Add(o); return true; }
public interface IElement { // Methods bool IsContent(); bool IsNestable(); bool Process(IElementListener listener); string ToString(); // Properties IList<Chunk> Chunks { get; } int Type { get; } }
以上的add()方法是向段落添加元素,我们可以看到参数是个接口“IElement”,我们接下来看一下这个接口,接口主要元素是块。我们看到在向段落添加元素时,可以添加List,Image,Paragraph,Chunk。
3.Image.GetInstance()获取图片实例。