开源免费且稳定实用的.NET PDF打印组件itextSharp(.NET组件介绍之八)

     在这个.NET组件的介绍系列中,受到了很多园友的支持,一些园友(如:数据之巅、 [秦时明月]等等这些大神 )也给我提出了对应的建议,我正在努力去改正,有不足之处还望大家多多包涵。在传播一些简单的知识的同时,我自己也得到了一些提升,这个是我感觉到的最大的益处。知识需要传播,在传播的过程中去让学习的人去提升,在交流中的过程中去让思考的人去展望,我希望我也能在这个传播的过程中出一份力。由于自身能力有限,在编写博文时出现的错误和一些不到位的讲解,还望大家多多见谅。

    上面卖完情怀,下面就该切入正题了。(自己申请了一个微信公众号““DotNet技术分享”,分享好的文章,希望有兴趣的可以加一下,也可以投稿,让知识传播给更多人。)

     提到打印,恐怕对于很多人都不会陌生,无论是开发者,还是非计算机专业的人员都会接触到打印。对于项目开发中使用到打印的地方会非常多,在.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()方法:打开文档对象。

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()获取图片实例。

public static Image GetInstance(Image image)
{
    if (image == null)
    {
        return null;
    }
    return (Image) image.GetType().GetConstructor(BindingFlags.Public | BindingFlags.Instance, null, new Type[] { typeof(Image) }, null).Invoke(new object[] { image });
}

 
public static Image GetInstance(byte[] imgb)
{
    int num = imgb[0];
    int num2 = imgb[1];
    int num3 = imgb[2];
    int num4 = imgb[3];
    if (((num == 0x47) && (num2 == 0x49)) && (num3 == 70))
    {
        GifImage image = new GifImage(imgb);
        return image.GetImage(1);
    }
    if ((num == 0xff) && (num2 == 0xd8))
    {
        return new Jpeg(imgb);
    }
    if (((num == 0) && (num2 == 0)) && ((num3 == 0) && (num4 == 12)))
    {
        return new Jpeg2000(imgb);
    }
    if (((num == 0xff) && (num2 == 0x4f)) && ((num3 == 0xff) && (num4 == 0x51)))
    {
        return new Jpeg2000(imgb);
    }
    if (((num == PngImage.PNGID[0]) && (num2 == PngImage.PNGID[1])) && ((num3 == PngImage.PNGID[2]) && (num4 == PngImage.PNGID[3])))
    {
        return PngImage.GetImage(imgb);
    }
    if ((num == 0xd7) && (num2 == 0xcd))
    {
        return new ImgWMF(imgb);
    }
    if ((num == 0x42) && (num2 == 0x4d))
    {
        return BmpImage.GetImage(imgb);
    }
    if ((((num == 0x4d) && (num2 == 0x4d)) && ((num3 == 0) && (num4 == 0x2a))) || (((num == 0x49) && (num2 == 0x49)) && ((num3 == 0x2a) && (num4 == 0))))
    {
        RandomAccessFileOrArray s = null;
        try
        {
            s = new RandomAccessFileOrArray(imgb);
            Image tiffImage = TiffImage.GetTiffImage(s, 1);
            if (tiffImage.OriginalData == null)
            {
                tiffImage.OriginalData = imgb;
            }
            return tiffImage;
        }
        finally
        {
            if (s != null)
            {
                s.Close();
            }
        }
    }
    throw new IOException(MessageLocalization.GetComposedMessage("the.byte.array.is.not.a.recognized.imageformat"));
}

    该方法根据参数获取图片实例的方式比较多,例如:Image,PdfTemplate,PRIndirectReference,byte[],Stream,string ,Uri等等,以上给出了根据Image和byte[]获取ItextSharp的image实例。

    4.Image的ScaleAbsolute():设置图片信息。

public void ScaleAbsolute(float newWidth, float newHeight)
{
    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()方法:重写链接的处理方法。

public override bool Process(IElementListener listener)
{
    try
    {
        bool flag = (this.reference != null) && this.reference.StartsWith("#");
        bool flag2 = true;
        foreach (Chunk chunk in this.Chunks)
        {
            if (((this.name != null) && flag2) && !chunk.IsEmpty())
            {
                chunk.SetLocalDestination(this.name);
                flag2 = false;
            }
            if (flag)
            {
                chunk.SetLocalGoto(this.reference.Substring(1));
            }
            else if (this.reference != null)
            {
                chunk.SetAnchor(this.reference);
            }
            listener.Add(chunk);
        }
        return true;
    }
    catch (DocumentException)
    {
        return false;
    }
}

     以上方法可以看到,该方法是在本类中被重写,用以处理链接的相关信息。

   6.PageSize:设置纸张的类型。

public class PageSize
{
    // Fields
    public static readonly Rectangle _11X17;
    public static readonly Rectangle A0;
    public static readonly Rectangle A1;
    public static readonly Rectangle A10;
    public static readonly Rectangle A2;
    public static readonly Rectangle A3;
    public static readonly Rectangle A4;
    public static readonly Rectangle A4_LANDSCAPE;
    public static readonly Rectangle A5;
    public static readonly Rectangle A6;
    public static readonly Rectangle A7;
    public static readonly Rectangle A8;
    public static readonly Rectangle A9;
    public static readonly Rectangle ARCH_A;
    public static readonly Rectangle ARCH_B;
    public static readonly Rectangle ARCH_C;
    public static readonly Rectangle ARCH_D;
    public static readonly Rectangle ARCH_E;
    public static readonly Rectangle B0;
    public static readonly Rectangle B1;
    public static readonly Rectangle B10;
    public static readonly Rectangle B2;
    public static readonly Rectangle B3;
    public static readonly Rectangle B4;
    public static readonly Rectangle B5;
    public static readonly Rectangle B6;
    public static readonly Rectangle B7;
    public static readonly Rectangle B8;
    public static readonly Rectangle B9;
    public static readonly Rectangle CROWN_OCTAVO;
    public static readonly Rectangle CROWN_QUARTO;
    public static readonly Rectangle DEMY_OCTAVO;
    public static readonly Rectangle DEMY_QUARTO;
    public static readonly Rectangle EXECUTIVE;
    public static readonly Rectangle FLSA;
    public static readonly Rectangle FLSE;
    public static readonly Rectangle HALFLETTER;
    public static readonly Rectangle ID_1;
    public static readonly Rectangle ID_2;
    public static readonly Rectangle ID_3;
    public static readonly Rectangle LARGE_CROWN_OCTAVO;
    public static readonly Rectangle LARGE_CROWN_QUARTO;
    public static readonly Rectangle LEDGER;
    public static readonly Rectangle LEGAL;
    public static readonly Rectangle LEGAL_LANDSCAPE;
    public static readonly Rectangle LETTER;
    public static readonly Rectangle LETTER_LANDSCAPE;
    public static readonly Rectangle NOTE;
    public static readonly Rectangle PENGUIN_LARGE_PAPERBACK;
    public static readonly Rectangle PENGUIN_SMALL_PAPERBACK;
    public static readonly Rectangle POSTCARD;
    public static readonly Rectangle ROYAL_OCTAVO;
    public static readonly Rectangle ROYAL_QUARTO;
    public static readonly Rectangle SMALL_PAPERBACK;
    public static readonly Rectangle TABLOID;

    // Methods
    static PageSize();
    public PageSize();
    public static Rectangle GetRectangle(string name);
}

   以上的类中,我们可以看到我们可以设置需要打印的纸张类型,根据实际情况可以选择。在最下面我们看到了两种方法,一个是PageSize()设置纸张大小,一个是GetRectangle()绘制矩形。

  以上是对itextSharp组件的一些类和方法的简单介绍,对于表格,单元格等等类的介绍就不再继续,有兴趣的可以自己查看源代码信息。

三.itextSharp组件实例:

   上面介绍了itextSharp组件的背景、特性,以及组件的核心类和方法,在这里给出一个简单的itextSharp组件操作的实例,这个实例只是一个简单的介绍。

        /// <summary>
        /// 字体
        /// </summary>
        private Font _font;

        /// <summary>
        /// 文档大小
        /// </summary>
        private Rectangle _rect;

        /// <summary>
        /// 文档对象
        /// </summary>
        private readonly Document _document;

        /// <summary>
        /// 基础字体
        /// </summary>
        private BaseFont _basefont;

        /// <summary>
        /// 构造函数
        /// </summary>
        public PDFOperation()
        {
            _rect = PageSize.A4;
            _document = new Document(_rect);
        }

        /// <summary>
        /// 构造函数
        /// </summary>
        /// <param name="type">页面大小(如"A4")</param>
        public PDFOperation(string type)
        {
            if (string.IsNullOrEmpty(type))
            {
                throw new ArgumentNullException(type);
            }
            SetPageSize(type);
            _document = new Document(_rect);
        }

        /// <summary>
        /// 构造函数
        /// </summary>
        /// <param name="type">页面大小(如"A4")</param>
        /// <param name="marginLeft">内容距左边框距离</param>
        /// <param name="marginRight">内容距右边框距离</param>
        /// <param name="marginTop">内容距上边框距离</param>
        /// <param name="marginBottom">内容距下边框距离</param>
        public PDFOperation(string type, float marginLeft, float marginRight, float marginTop, float marginBottom)
        {
            if (string.IsNullOrEmpty(type))
            {
                throw new ArgumentNullException(type);
            }
            SetPageSize(type);
            _document = new Document(_rect, marginLeft, marginRight, marginTop, marginBottom);
        }



        /// <summary>
        /// 设置字体
        /// </summary>
        public void SetBaseFont(string path)
        {
            if (string.IsNullOrEmpty(path))
            {
                throw new ArgumentNullException(path);
            }
            _basefont = BaseFont.CreateFont(path, BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
        }

        /// <summary>
        /// 设置字体
        /// </summary>
        /// <param name="size">字体大小</param>
        public void SetFont(float size)
        {
            _font = new Font(_basefont, size);
        }

        /// <summary>
        /// 设置页面大小
        /// </summary>
        /// <param name="type">页面大小(如"A4")</param>
        public void SetPageSize(string type)
        {
            if (string.IsNullOrEmpty(type))
            {
                throw new ArgumentNullException(type);
            }
            switch (type.Trim())
            {
                //枚举需要的文档纸张大小
                case "A3":
                    _rect = PageSize.A3;
                    break;
                case "A4":
                    _rect = PageSize.A4;
                    break;
                case "A8":
                    _rect = PageSize.A8;
                    break;
            }
        }

        /// <summary>
        /// 实例化文档
        /// </summary>
        /// <param name="os">文档相关信息(如路径,打开方式等)</param>
        public void GetInstance(Stream os)
        {
            if (os == null)
            {
                throw new ArgumentNullException("os");
            }
            PdfWriter.GetInstance(_document, os);
        }

        /// <summary>
        /// 打开文档对象
        /// </summary>
        /// <param name="os">文档相关信息(如路径,打开方式等)</param>
        public void Open(Stream os)
        {
            if (os == null)
            {
                throw new ArgumentNullException("os");
            }
            GetInstance(os);
            _document.Open();
        }

        /// <summary>
        /// 关闭打开的文档
        /// </summary>
        public void Close()
        {
            _document.Close();
        }

        /// <summary>
        /// 添加段落
        /// </summary>
        /// <param name="content">内容</param>
        /// <param name="fontsize">字体大小</param>
        public void AddParagraph(string content, float fontsize)
        {
            SetFont(fontsize);
            var pra = new Paragraph(content, _font);
            _document.Add(pra);
        }

        /// <summary>
        /// 添加段落
        /// </summary>
        /// <param name="content">内容</param>
        /// <param name="fontsize">字体大小</param>
        /// <param name="alignment">对齐方式(1为居中,0为居左,2为居右)</param>
        /// <param name="spacingAfter">段后空行数(0为默认值)</param>
        /// <param name="spacingBefore">段前空行数(0为默认值)</param>
        /// <param name="multipliedLeading">行间距(0为默认值)</param>
        public void AddParagraph(string content, float fontsize, int alignment, float spacingAfter, float spacingBefore, float multipliedLeading)
        {
            SetFont(fontsize);
            var pra = new Paragraph(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>
        /// <param name="path">图片路径</param>
        /// <param name="alignment">对齐方式(1为居中,0为居左,2为居右)</param>
        /// <param name="newWidth">图片宽(0为默认值,如果宽度大于页宽将按比率缩放)</param>
        /// <param name="newHeight">图片高</param>
        public void AddImage(string path, int alignment, float newWidth, float newHeight)
        {
            if (string.IsNullOrEmpty(path))
            {
                throw new ArgumentNullException(path);
            }
            var img = Image.GetInstance(path);
            img.Alignment = alignment;
            // ReSharper disable once CompareOfFloatsByEqualityOperator
            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>
        /// <param name="content">链接文字</param>
        /// <param name="fontSize">字体大小</param>
        /// <param name="reference">链接地址</param>
        public void AddAnchorReference(string content, float fontSize, string reference)
        {
            if (string.IsNullOrEmpty(content))
            {
                throw new ArgumentNullException(content);
            }
            SetFont(fontSize);
            var auc = new Anchor(content, _font)
            {
                Reference = reference
            };
            _document.Add(auc);
        }

        /// <summary>
        /// 添加链接点
        /// </summary>
        /// <param name="content">链接文字</param>
        /// <param name="fontSize">字体大小</param>
        /// <param name="name">链接点名</param>
        public void AddAnchorName(string content, float fontSize, string name)
        {
            if (string.IsNullOrEmpty(content))
            {
                throw new ArgumentNullException(content);
            }
            SetFont(fontSize);
            var auc = new Anchor(content, _font)
            {
                Name = name
            };
            _document.Add(auc);
        }

    以上的实例比较的简单,主要是用作简单介绍组件的用法。如果需要将组件设计的更加通用,我们可以将组件的相关类和方法重写,并且可以开发一套cs或者bs程序,实现组件的图形化操作,图形化操作生成文件模板。文件模板可以将相关信息序列化(json或者二进制),在项目中直接加载模型,并将数据绑定在模板中,实现pdf打印的动态配置。

   这个程序的开发难度一般,如果有兴趣的可以自行开发一套工具,可以更好的实现我们的项目pdf打印功能。

四.总结:

    上面介绍了itextSharp组件的相关信息,在这个系列的组件介绍中,对于组件的介绍都是比较的简单,旨在向大家介绍这个组件,在实际的开发中,我们可以根据实际情况自行选择相应的组件,组件没有绝对的好坏,只有合适的场景。

    以上讲解若有错误和不足之处,希望大家多多见谅和多多提出意见和建议。

.NET组件介绍系列:

  一款开源免费的.NET文档操作组件DocX(.NET组件介绍之一)

高效而稳定的企业级.NET Office 组件Spire(.NET组件介绍之二)

  最好的.NET开源免费ZIP库DotNetZip(.NET组件介绍之三)

免费开源的DotNet二维码操作组件ThoughtWorks.QRCode(.NET组件介绍之四)

免费开源的DotNet任务调度组件Quartz.NET(.NET组件介绍之五)

免费高效实用的Excel操作组件NPOI(.NET组件介绍之六)

   免费开源的.NET多类型文件解压缩组件SharpZipLib(.NET组件介绍之七)

   口碑和性能都高的.NET PDF打印组件itextSharp(.NET组件介绍之八)

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏守候书阁

用vue开发一个所谓的数独

最近的后台管理系统页面,功能暂时没有新的需求,就在想首页放什么东西,最近我想到的就是放个所谓的数独,为什么是所谓的数独,因为规则不同于标准的数独,只要求每一行每...

1854
来自专栏C#

开源免费的.NET图像即时处理的组件ImageProcessor

   承接以前的组件系列,这个组件系列旨在介绍.NET相关的组件,让大家可以在项目中有一个更好的选择组件的介绍绝对不是一篇文章可以叙述完的,因为一个组件是经过开...

3108
来自专栏C#

开源免费的.NET图像即时处理的组件ImageProcessor

   承接以前的组件系列,这个组件系列旨在介绍.NET相关的组件,让大家可以在项目中有一个更好的选择,社区对于第三方插件的介绍还是比较少的,很多博文的内容主要还...

1090
来自专栏落影的专栏

GPUImage详细解析

从源码的角度分析、学习GPUImage和OpenGL ES,这是第一篇,介绍GPUImageFilter 和 GPUImageFramebuffer。 Open...

3496
来自专栏落影的专栏

GPUImage详细解析(九)图像的输入输出和滤镜通道

前言 GPUImage系列解析已经接近尾声,这次介绍的是: 纹理输入输出GPUImageTextureOutput 和 GPUImageTextureOutpu...

5378
来自专栏码匠的流水账

聊聊qrcode的detect position

本文主要介绍下qrcode的detect position,也就是定位图案,用于定位一张图片中二维码所处的位置。

2561
来自专栏人工智能LeadAI

Tensorflow中卷积的padding操作

之前一直对tensorflow的padding一知半解,直到查阅了tensorflow/core/kernels/ops_util.cc中的Get2dOutpu...

4259
来自专栏iOSer成长记录

OpenGL ES(一) 初识

1105
来自专栏LeoXu的博客

iText的使用

首先要getInstance并open一个Document对象,该对象也就代表了这个文件:

4881
来自专栏数据结构与算法

BZOJ1563: [NOI2009]诗人小G(决策单调性 前缀和 dp)

\(f_i = min(f_j + (sum_i - sum_j - 1 - L)^P)\)

1553

扫码关注云+社区

领取腾讯云代金券