详解开源免费且稳定实用的.NET PDF打印组件itextSharp（.NET组件介绍之八）
在这个.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产品介绍。https://sourceforge.net/projects/itextsharp/#overview。
二.itextSharp组件核心类和方法：
谈到打印，在我们的项目中需要首先考虑的是我们需要打印的东西是什么。在大脑里面应该首先有一个文档的概念，在我们编程的过程中，“文档”这个词无处不在，这个可以是一个宽泛的概念，也可以是一个狭窄的概念，宽泛的“文档”是指容器，用以存放一些元素；狭窄的“文档”是指实际的文件类型。
对于打印的“文档”，具体看一下宽泛的概念，文档包含元素和节点等等。在组织打印的时候，我们需要创建文档，写入元素和节点等信息，最后组合成为我们需要打印的内容。itextSharp组件可以插入段落、表格、图片等等信息，可以很方便的完成我们需要完成的功能。
Paragraph：报表中的文本；Image：报表中的图片；PdfPTable：表格；PdfPCell：单元格。
1.Document类Open()方法：打开文档对象。
publicvirtualvoidOpen()
{
if(!this.close)
{
this.open=true;
}
foreach(IDocListenerlistenerinthis.listeners)
{
listener.SetPageSize(this.pageSize);
listener.SetMargins(this.marginLeft,this.marginRight,this.marginTop,this.marginBottom);
listener.Open();
}
}
以上的代码可以看到，我们在打开文档的时候，会设置文档大小，文档页边距等信息。
2.Paragraph类Add()方法：向段落添加元素。
publicoverrideboolAdd(IElemento)
{
if(oisList)
{
Listelement=(List)o;
element.IndentationLeft+=this.indentationLeft;
element.IndentationRight=this.indentationRight;
base.Add(element);
returntrue;
}
if(oisImage)
{
base.AddSpecial((Image)o);
returntrue;
}
if(oisParagraph)
{
base.Add(o);
IList<Chunk>chunks=this.Chunks;
if(chunks.Count>0)
{
Chunkchunk=chunks[chunks.Count-1];
base.Add(newChunk("\n",chunk.Font));
}
else
{
base.Add(Chunk.NEWLINE);
}
returntrue;
}
base.Add(o);
returntrue;
}
publicinterfaceIElement
{
//Methods
boolIsContent();
boolIsNestable();
boolProcess(IElementListenerlistener);
stringToString();
//Properties
IList<Chunk>Chunks{get;}
intType{get;}
}
以上的add()方法是向段落添加元素，我们可以看到参数是个接口“IElement”，我们接下来看一下这个接口，接口主要元素是块。我们看到在向段落添加元素时，可以添加List，Image，Paragraph，Chunk。
3.Image.GetInstance()获取图片实例。
publicstaticImageGetInstance(Imageimage)
{
if(image==null)
{
returnnull;
}
return(Image)image.GetType().GetConstructor(BindingFlags.Public|BindingFlags.Instance,null,newType[]{typeof(Image)},null).Invoke(newobject[]{image});
}
publicstaticImageGetInstance(byte[]imgb)
{
intnum=imgb[0];
intnum2=imgb[1];
intnum3=imgb[2];
intnum4=imgb[3];
if(((num==0x47)&&(num2==0x49))&&(num3==70))
{
GifImageimage=newGifImage(imgb);
returnimage.GetImage(1);
}
if((num==0xff)&&(num2==0xd8))
{
returnnewJpeg(imgb);
}
if(((num==0)&&(num2==0))&&((num3==0)&&(num4==12)))
{
returnnewJpeg2000(imgb);
}
if(((num==0xff)&&(num2==0x4f))&&((num3==0xff)&&(num4==0x51)))
{
returnnewJpeg2000(imgb);
}
if(((num==PngImage.PNGID[0])&&(num2==PngImage.PNGID[1]))&&((num3==PngImage.PNGID[2])&&(num4==PngImage.PNGID[3])))
{
returnPngImage.GetImage(imgb);
}
if((num==0xd7)&&(num2==0xcd))
{
returnnewImgWMF(imgb);
}
if((num==0x42)&&(num2==0x4d))
{
returnBmpImage.GetImage(imgb);
}
if((((num==0x4d)&&(num2==0x4d))&&((num3==0)&&(num4==0x2a)))||(((num==0x49)&&(num2==0x49))&&((num3==0x2a)&&(num4==0))))
{
RandomAccessFileOrArrays=null;
try
{
s=newRandomAccessFileOrArray(imgb);
ImagetiffImage=TiffImage.GetTiffImage(s,1);
if(tiffImage.OriginalData==null)
{
tiffImage.OriginalData=imgb;
}
returntiffImage;
}
finally
{
if(s!=null)
{
s.Close();
}
}
}
thrownewIOException(MessageLocalization.GetComposedMessage("the.byte.array.is.not.a.recognized.imageformat"));
}
该方法根据参数获取图片实例的方式比较多，例如：Image，PdfTemplate，PRIndirectReference，byte[]，Stream，string，Uri等等，以上给出了根据Image和byte[]获取ItextSharp的image实例。
4.Image的ScaleAbsolute()：设置图片信息。
publicvoidScaleAbsolute(floatnewWidth,floatnewHeight)
{
this.plainWidth=newWidth;
this.plainHeight=newHeight;
float[]matrix=this.Matrix;
this.scaledWidth=matrix[6]-matrix[4];
this.scaledHeight=matrix[7]-matrix[5];
this.WidthPercentage=0f;
}
以上代码可以看出，设置图片的信息主要包括高度、宽度、排列等信息。
5.Anchor类的Process()方法：重写链接的处理方法。
publicoverrideboolProcess(IElementListenerlistener)
{
try
{
boolflag=(this.reference!=null)&&this.reference.StartsWith("#");
boolflag2=true;
foreach(Chunkchunkinthis.Chunks)
{
if(((this.name!=null)&&flag2)&&!chunk.IsEmpty())
{
chunk.SetLocalDestination(this.name);
flag2=false;
}
if(flag)
{
chunk.SetLocalGoto(this.reference.Substring(1));
}
elseif(this.reference!=null)
{
chunk.SetAnchor(this.reference);
}
listener.Add(chunk);
}
returntrue;
}
catch(DocumentException)
{
returnfalse;
}
}
以上方法可以看到，该方法是在本类中被重写，用以处理链接的相关信息。
6.PageSize：设置纸张的类型。
publicclassPageSize
{
//Fields
publicstaticreadonlyRectangle_11X17;
publicstaticreadonlyRectangleA0;
publicstaticreadonlyRectangleA1;
publicstaticreadonlyRectangleA10;
publicstaticreadonlyRectangleA2;
publicstaticreadonlyRectangleA3;
publicstaticreadonlyRectangleA4;
publicstaticreadonlyRectangleA4_LANDSCAPE;
publicstaticreadonlyRectangleA5;
publicstaticreadonlyRectangleA6;
publicstaticreadonlyRectangleA7;
publicstaticreadonlyRectangleA8;
publicstaticreadonlyRectangleA9;
publicstaticreadonlyRectangleARCH_A;
publicstaticreadonlyRectangleARCH_B;
publicstaticreadonlyRectangleARCH_C;
publicstaticreadonlyRectangleARCH_D;
publicstaticreadonlyRectangleARCH_E;
publicstaticreadonlyRectangleB0;
publicstaticreadonlyRectangleB1;
publicstaticreadonlyRectangleB10;
publicstaticreadonlyRectangleB2;
publicstaticreadonlyRectangleB3;
publicstaticreadonlyRectangleB4;
publicstaticreadonlyRectangleB5;
publicstaticreadonlyRectangleB6;
publicstaticreadonlyRectangleB7;
publicstaticreadonlyRectangleB8;
publicstaticreadonlyRectangleB9;
publicstaticreadonlyRectangleCROWN_OCTAVO;
publicstaticreadonlyRectangleCROWN_QUARTO;
publicstaticreadonlyRectangleDEMY_OCTAVO;
publicstaticreadonlyRectangleDEMY_QUARTO;
publicstaticreadonlyRectangleEXECUTIVE;
publicstaticreadonlyRectangleFLSA;
publicstaticreadonlyRectangleFLSE;
publicstaticreadonlyRectangleHALFLETTER;
publicstaticreadonlyRectangleID_1;
publicstaticreadonlyRectangleID_2;
publicstaticreadonlyRectangleID_3;
publicstaticreadonlyRectangleLARGE_CROWN_OCTAVO;
publicstaticreadonlyRectangleLARGE_CROWN_QUARTO;
publicstaticreadonlyRectangleLEDGER;
publicstaticreadonlyRectangleLEGAL;
publicstaticreadonlyRectangleLEGAL_LANDSCAPE;
publicstaticreadonlyRectangleLETTER;
publicstaticreadonlyRectangleLETTER_LANDSCAPE;
publicstaticreadonlyRectangleNOTE;
publicstaticreadonlyRectanglePENGUIN_LARGE_PAPERBACK;
publicstaticreadonlyRectanglePENGUIN_SMALL_PAPERBACK;
publicstaticreadonlyRectanglePOSTCARD;
publicstaticreadonlyRectangleROYAL_OCTAVO;
publicstaticreadonlyRectangleROYAL_QUARTO;
publicstaticreadonlyRectangleSMALL_PAPERBACK;
publicstaticreadonlyRectangleTABLOID;
//Methods
staticPageSize();
publicPageSize();
publicstaticRectangleGetRectangle(stringname);
}
以上的类中，我们可以看到我们可以设置需要打印的纸张类型，根据实际情况可以选择。在最下面我们看到了两种方法，一个是PageSize()设置纸张大小，一个是GetRectangle()绘制矩形。
以上是对itextSharp组件的一些类和方法的简单介绍，对于表格，单元格等等类的介绍就不再继续，有兴趣的可以自己查看源代码信息。
三.itextSharp组件实例：
上面介绍了itextSharp组件的背景、特性，以及组件的核心类和方法，在这里给出一个简单的itextSharp组件操作的实例，这个实例只是一个简单的介绍。
///<summary>
///字体
///</summary>
privateFont_font;
///<summary>
///文档大小
///</summary>
privateRectangle_rect;
///<summary>
///文档对象
///</summary>
privatereadonlyDocument_document;
///<summary>
///基础字体
///</summary>
privateBaseFont_basefont;
///<summary>
///构造函数
///</summary>
publicPDFOperation()
{
_rect=PageSize.A4;
_document=newDocument(_rect);
}
///<summary>
///构造函数
///</summary>
///<paramname="type">页面大小(如"A4")</param>
publicPDFOperation(stringtype)
{
if(string.IsNullOrEmpty(type))
{
thrownewArgumentNullException(type);
}
SetPageSize(type);
_document=newDocument(_rect);
}
///<summary>
///构造函数
///</summary>
///<paramname="type">页面大小(如"A4")</param>
///<paramname="marginLeft">内容距左边框距离</param>
///<paramname="marginRight">内容距右边框距离</param>
///<paramname="marginTop">内容距上边框距离</param>
///<paramname="marginBottom">内容距下边框距离</param>
publicPDFOperation(stringtype,floatmarginLeft,floatmarginRight,floatmarginTop,floatmarginBottom)
{
if(string.IsNullOrEmpty(type))
{
thrownewArgumentNullException(type);
}
SetPageSize(type);
_document=newDocument(_rect,marginLeft,marginRight,marginTop,marginBottom);
}
///<summary>
///设置字体
///</summary>
publicvoidSetBaseFont(stringpath)
{
if(string.IsNullOrEmpty(path))
{
thrownewArgumentNullException(path);
}
_basefont=BaseFont.CreateFont(path,BaseFont.IDENTITY_H,BaseFont.NOT_EMBEDDED);
}
///<summary>
///设置字体
///</summary>
///<paramname="size">字体大小</param>
publicvoidSetFont(floatsize)
{
_font=newFont(_basefont,size);
}
///<summary>
///设置页面大小
///</summary>
///<paramname="type">页面大小(如"A4")</param>
publicvoidSetPageSize(stringtype)
{
if(string.IsNullOrEmpty(type))
{
thrownewArgumentNullException(type);
}
switch(type.Trim())
{
//枚举需要的文档纸张大小
case"A3":
_rect=PageSize.A3;
break;
case"A4":
_rect=PageSize.A4;
break;
case"A8":
_rect=PageSize.A8;
break;
}
}
///<summary>
///实例化文档
///</summary>
///<paramname="os">文档相关信息（如路径，打开方式等）</param>
publicvoidGetInstance(Streamos)
{
if(os==null)
{
thrownewArgumentNullException("os");
}
PdfWriter.GetInstance(_document,os);
}
///<summary>
///打开文档对象
///</summary>
///<paramname="os">文档相关信息（如路径，打开方式等）</param>
publicvoidOpen(Streamos)
{
if(os==null)
{
thrownewArgumentNullException("os");
}
GetInstance(os);
_document.Open();
}
///<summary>
///关闭打开的文档
///</summary>
publicvoidClose()
{
_document.Close();
}
///<summary>
///添加段落
///</summary>
///<paramname="content">内容</param>
///<paramname="fontsize">字体大小</param>
publicvoidAddParagraph(stringcontent,floatfontsize)
{
SetFont(fontsize);
varpra=newParagraph(content,_font);
_document.Add(pra);
}
///<summary>
///添加段落
///</summary>
///<paramname="content">内容</param>
///<paramname="fontsize">字体大小</param>
///<paramname="alignment">对齐方式（1为居中，0为居左，2为居右）</param>
///<paramname="spacingAfter">段后空行数（0为默认值）</param>
///<paramname="spacingBefore">段前空行数（0为默认值）</param>
///<paramname="multipliedLeading">行间距（0为默认值）</param>
publicvoidAddParagraph(stringcontent,floatfontsize,intalignment,floatspacingAfter,floatspacingBefore,floatmultipliedLeading)
{
SetFont(fontsize);
varpra=newParagraph(content,_font)
{
Alignment=alignment
};
if(spacingAfter!=0)
{
pra.SpacingAfter=spacingAfter;
}
if(spacingBefore!=0)
{
pra.SpacingBefore=spacingBefore;
}
if(multipliedLeading!=0)
{
pra.MultipliedLeading=multipliedLeading;
}
_document.Add(pra);
}
///<summary>
///添加图片
///</summary>
///<paramname="path">图片路径</param>
///<paramname="alignment">对齐方式（1为居中，0为居左，2为居右）</param>
///<paramname="newWidth">图片宽（0为默认值，如果宽度大于页宽将按比率缩放）</param>
///<paramname="newHeight">图片高</param>
publicvoidAddImage(stringpath,intalignment,floatnewWidth,floatnewHeight)
{
if(string.IsNullOrEmpty(path))
{
thrownewArgumentNullException(path);
}
varimg=Image.GetInstance(path);
img.Alignment=alignment;
//ReSharperdisableonceCompareOfFloatsByEqualityOperator
if(newWidth!=0)
{
img.ScaleAbsolute(newWidth,newHeight);
}
else
{
if(img.Width>PageSize.A4.Width)
{
img.ScaleAbsolute(_rect.Width,img.Width*img.Height/_rect.Height);
}
}
_document.Add(img);
}
///<summary>
///添加链接
///</summary>
///<paramname="content">链接文字</param>
///<paramname="fontSize">字体大小</param>
///<paramname="reference">链接地址</param>
publicvoidAddAnchorReference(stringcontent,floatfontSize,stringreference)
{
if(string.IsNullOrEmpty(content))
{
thrownewArgumentNullException(content);
}
SetFont(fontSize);
varauc=newAnchor(content,_font)
{
Reference=reference
};
_document.Add(auc);
}
///<summary>
///添加链接点
///</summary>
///<paramname="content">链接文字</param>
///<paramname="fontSize">字体大小</param>
///<paramname="name">链接点名</param>
publicvoidAddAnchorName(stringcontent,floatfontSize,stringname)
{
if(string.IsNullOrEmpty(content))
{
thrownewArgumentNullException(content);
}
SetFont(fontSize);
varauc=newAnchor(content,_font)
{
Name=name
};
_document.Add(auc);
}
以上的实例比较的简单，主要是用作简单介绍组件的用法。如果需要将组件设计的更加通用，我们可以将组件的相关类和方法重写，并且可以开发一套cs或者bs程序，实现组件的图形化操作，图形化操作生成文件模板。文件模板可以将相关信息序列化（json或者二进制），在项目中直接加载模型，并将数据绑定在模板中，实现pdf打印的动态配置。
这个程序的开发难度一般，如果有兴趣的可以自行开发一套工具，可以更好的实现我们的项目pdf打印功能。
四.总结：
上面介绍了itextSharp组件的相关信息，在这个系列的组件介绍中，对于组件的介绍都是比较的简单，旨在向大家介绍这个组件，在实际的开发中，我们可以根据实际情况自行选择相应的组件，组件没有绝对的好坏，只有合适的场景。
以上讲解若有错误和不足之处，希望大家多多见谅和多多提出意见和建议。也希望大家多多支持毛票票。