iTextSharp操作PDF

Posted 2020-12-11 springsnow

一、介绍

iTextSharp：是一个从JAVA项目iText衍生的.Net版本的开源项目。iText是一个PDF库，可让您创建，移植，检查和维护可移植文档格式（PDF）的文档，从而使您可以轻松地向软件项目添加PDF功能。我们甚至提供文档来帮助您进行编码。

可以操作PDF的库还有

• PDFsharp ：PDFsharp是一个开源.NET库，它可以通过任何.NET语言轻松地动态创建和处理PDF文档。相同的绘图例程可用于创建PDF文档，在屏幕上绘图或将输出发送到任何打印机。
• Aspose.PDF：用于.NET的Aspose.PDF是PDF文档创建和处理组件，它使您的.NET应用程序无需使用Adobe Acrobat即可读取，编写和处理现有的PDF文档。它还允许您创建表单并管理嵌入PDF文档中的表单字段。
• Spire.PDF：Spire.PDF for .NET是一个通用的PDF库，使软件开发人员可以在自己的.NET应用程序中生成，编辑，阅读和操作PDF文件。作为独立的PDF组件，Spire.PDF for .NET无需安装Adobe Acrobat，即可为用户提供令人难以置信的丰富功能。
• Rotativa：是一个提供免费API的框架，用于提供在ASP.NET MVC应用程序中打印PDF文档的极其简单的方法。Rotativa基于wkhtmltopdf工具，用于在HTML中创建一个在浏览器中呈现的PDF文档

二、使用

1.首先下载该组件并添加引用，这里是使用VS自带的NuGet来进行安装的，键项目选择管理NuGet程序包，搜索iTextSharp选择合适版本安装即可，安装完成会自动添加引用。

iTextSharp最新版本为5.5.13.1

2.在使用的文件里面引入命名空间

using iTextSharp.text;
using iTextSharp.text.pdf;

3.简单的生成PDF文件，其中Fname为生成文件存放的路径。

简单说一下：

• Rectangle对象：用来设置PDF页面尺寸。
• Document对象：页面对象，就像是HTML里面的页面对象一样，用于操作页面内容和格式。
• PdfWriter对象：用于将Document对象写入PDF文件。

Rectangle pageSize = new Rectangle(1000, 500);
Document document = new Document(pageSize, 10, 10, 120, 80);
PdfWriter writer = PdfWriter.GetInstance(document, new FileStream(Fname, FileMode.Create));
document.Open();
document.Add(new iTextSharp.text.Paragraph("Hello World! Hello People! " +
            "Hello Sky! Hello Sun! Hello Moon! Hello Stars!"));
document.Close();
writer.Close();

4.设置PDF文档信息，利用Document对象。

document.AddTitle("这里是标题");
document.AddSubject("主题");
document.AddKeywords("关键字");
document.AddCreator("创建者");
document.AddAuthor("作者");

5.向PDF里面添加图片，Fimg为图片路径，创建一个iTextSharp.text.Image对象，将该对象添加到文档里面，SetAbsolutePosition方法是设置图片出现的位置。

string imgurl = @System.Web.HttpContext.Current.Server.MapPath(Fimg);
iTextSharp.text.Image img = iTextSharp.text.Image.GetInstance(imgurl);
img.SetAbsolutePosition(0, 0);
writer.DirectContent.AddImage(img);

6.向PDF里面添加表格，表格对象为PdfTable对象。

该类的构造函数可以设置表格的列数，new float[] { 180, 140, 140, 160, 180, 140, 194 }里面是每列的宽度，也可在构造函数里面直接写列数如：new PdfPTable(3);

接下来需要将单元格扔到表格里面，单元格为PdfPCell对象，构造函数里面可以写入单元格要显示的文本信息，其中fontb为字体，如果是显示中文必须创建中文字体：

BaseFont bsFont = BaseFont.CreateFont(@System.Web.HttpContext.Current.Server.MapPath("./upload/fonts/MSYH.TTC") + ",0", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
Font fontb = new Font(bsFont, Tab_Content_FontSize, Font.BOLD, new BaseColor(0xFF, 0xFF, 0xFF));

单元格创建出来扔到表格中排列方式类似与HTML里面的流式布局，没有行一说，所以造的单元格数量和列数相挂钩才能显示正确。

单元格格式可以进行设置：

• HorizontalAlignment：代表单元格内文本的对齐方式
• PaddingBottom和PaddingTop：为单元格内间距（下，上）
• BorderColor：边框颜色
• SetLeading（）：该方法设置单元格内多行文本的行间距

PdfPTable tablerow1 = new PdfPTable(new float[] { 180, 140, 140, 160, 180, 140, 194 });
tablerow1.TotalWidth = 1000; //表格宽度
tablerow1.LockedWidth = true;
 
//造单元格
PdfPCell cell11 = new PdfPCell(new Paragraph("单元格内容", fontb));
cell11.HorizontalAlignment = 1;
cell11.PaddingBottom = 10;
cell11.PaddingTop = 10;
cell11.BorderColor = borderColor;
cell11.SetLeading(1.2f, 1.2f);
tablerow1.AddCell(cell11);//将单元格添加到表格中
            
document.Add(tablerow1);//将表格添加到pdf文档中

7.将文本放到页面指定位置PdfContentByte获取写入的文件流，将文本放到指定位置，位置为x和y坐标，其中y坐标是从下面往上走的。

PdfContentByte cb = writer.DirectContent;
Phrase txt = new Phrase("测试文本", fontb);
ColumnText.ShowTextAligned(cb, Element.ALIGN_LEFT, txt,  425, 460, 0);

8.创建新的页面，如果想要创建出新一页的话需要使用代码：

document.NewPage();

如果创建的新页面需要重新开始计算页数的话，在创建新页面之前：

document.ResetPageCount();

9.添加页眉页脚及水印，页脚需要显示页数，如果正常添加很简单，但需求里面要求有背景色，有水印，而且背景色在最底层，水印在上层，文字表格等在最上层，处理这个需求是整个iTextSharp最难的地方。

先分析一下，如果在创建Rectangle对象的时候添加背景色，那么接下来加水印有两种可选情况：

1.水印加在内容下面，可选，但水印会加到背景色的下面导致水印不显示。

2.水印加在内容上面，不可选，水印会覆盖最上层的文字，实现的效果不好。

为了解决这个问题，找到了iTextSharp提供的一个接口IPdfPageEvent及PdfPageEventHelper，该接口里面有一个方法可以实现，该方法为：OnEndPage当页面创建完成时触发执行。

那么就利用这个方法来实现：先添加背景色，再添加水印，添加在内容下方即可。

实现该方法需要一个类来实现接口：

public class IsHandF : PdfPageEventHelper, IPdfPageEvent
{
        /// <summary>
        /// 创建页面完成时发生 
        /// </summary>
        public override void OnEndPage(PdfWriter writer, Document document)
        {
            base.OnEndPage(writer, document);
 
            //页眉页脚使用字体
            BaseFont bsFont = BaseFont.CreateFont(@System.Web.HttpContext.Current.Server.MapPath("./upload/fonts/MSYH.TTC") + ",0", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
            iTextSharp.text.Font fontheader = new iTextSharp.text.Font(bsFont, 30, iTextSharp.text.Font.BOLD);
            iTextSharp.text.Font fontfooter = new iTextSharp.text.Font(bsFont, 20, iTextSharp.text.Font.BOLD);
            //水印文件地址
            string syurl = "./upload/images/sys/black.png";
               
            //获取文件流
            PdfContentByte cbs = writer.DirectContent;          

            cbs.SetCharacterSpacing(1.3f); //设置文字显示时的字间距
            Phrase header = new Phrase("页眉", fontheader);
            Phrase footer = new Phrase(writer.PageNumber.ToString(), fontfooter); //writer.PageNumber.ToString()为页码。
            //页眉显示的位置 
            ColumnText.ShowTextAligned(cbs, Element.ALIGN_CENTER, header,
                       document.Right / 2, document.Top + 40, 0);
            //页脚显示的位置 
            ColumnText.ShowTextAligned(cbs, Element.ALIGN_CENTER, footer,
                       document.Right / 2, document.Bottom - 40, 0);
 
            //添加背景色及水印，在内容下方添加
            PdfContentByte cba = writer.DirectContentUnder;
            //背景色
            Bitmap bmp = new Bitmap(1263, 893);
            Graphics g = Graphics.FromImage(bmp);
            Color c = Color.FromArgb(0x33ff33);
            SolidBrush b = new SolidBrush(c);//这里修改颜色
            g.FillRectangle(b, 0, 0, 1263, 893);
            System.Drawing.Image ig = bmp;
            iTextSharp.text.Image img = iTextSharp.text.Image.GetInstance(ig, new BaseColor(0xFF, 0xFF, 0xFF));
            img.SetAbsolutePosition(0, 0);
            cba.AddImage(img);
 
            //水印
            iTextSharp.text.Image image = iTextSharp.text.Image.GetInstance(@System.Web.HttpContext.Current.Server.MapPath(syurl));
            image.RotationDegrees = 30;//旋转角度
 
            PdfGState gs = new PdfGState();
            gs.FillOpacity = 0.1f;//透明度
            cba.SetGState(gs);
 
            int x = -1000;
            for (int j = 0; j < 15; j++)
            {
                x = x + 180;
                int a = x;
                int y = -170;
                for (int i = 0; i < 10; i++)
                {
                    a = a + 180;
                    y = y + 180;
                    image.SetAbsolutePosition(a, y);
                    cba.AddImage(image);
                }
            }
        }
    }

该类创建完成后，在需要添加页眉页脚水印的页面代码位置添加如下代码，整个文档生成过程中添加一次即可，确保该事件可以触发，添加该代码后在剩余的页面都会触发生成页眉页脚：

writer.PageEvent = new IsHandF();

以上即为该组件的基本用法，利用该组件可以对PDF文件进行各种各样的操作，当然还有加密PDF文件等比较简单本文就不做详细说明了。