程式師世界 >> 編程語言 >> .NET網頁編程 >> 關於.NET >> 開源免費且穩定實用的.NET PDF打印組件itextSharp（.NET組件介紹之八），打印組件itextsharp

開源免費且穩定實用的.NET PDF打印組件itextSharp（.NET組件介紹之八），打印組件itextsharp

編輯：關於.NET

開源免費且穩定實用的.NET PDF打印組件itextSharp（.NET組件介紹之八），打印組件itextsharp

在這個.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組件介紹之一）http://www.cnblogs.com/pengze0902/p/6122311.html

高效而穩定的企業級.NET Office 組件Spire（.NET組件介紹之二）http://www.cnblogs.com/pengze0902/p/6125570.html

最好的.NET開源免費ZIP庫DotNetZip（.NET組件介紹之三）http://www.cnblogs.com/pengze0902/p/6124659.html

免費開源的DotNet二維碼操作組件ThoughtWorks.QRCode（.NET組件介紹之四）http://www.cnblogs.com/pengze0902/p/6134506.html

免費開源的DotNet任務調度組件Quartz.NET（.NET組件介紹之五）http://www.cnblogs.com/pengze0902/p/6128558.html

免費高效實用的Excel操作組件NPOI（.NET組件介紹之六）http://www.cnblogs.com/pengze0902/p/6150070.html

免費開源的.NET多類型文件解壓縮組件SharpZipLib（.NET組件介紹之七）http://www.cnblogs.com/pengze0902/p/6159497.html

口碑和性能都高的.NET PDF打印組件itextSharp（.NET組件介紹之八）http://www.cnblogs.com/pengze0902/p/6178499.html

關於.NET

單例模式與靜態類的區別及優勢

有時候感覺單例模式與靜態類的區別並不是那麼明顯

信息系統開發平台OpenExpressApp - 使用CSLA類庫實現用戶管理

在《信息系統開發平台OpenExpressAp

Windows 8實例教程：布局控制

與傳統應用類似，Windows store應用

WCF技術剖析之二十六:如何導出WCF服務的元數據(Metadata)[實現篇]

元數據的導出就是實現從ServiceEndpo

數據點-預編譯LINQ查詢

在應用程序中使用 LINQ to SQL 或

服務站 - 基於WCF服務中的授權

目錄基於角色的授權ASP.NET 角色提供程序

熱門圖文

C#中的具名參數和可選參數， PHP新手上路（二） c++ mfc-c++中MFC程序在別人的機器上顯示缺少mfco42d.dll文件怎麼辦？ asp+sql登錄驗證-asp＋sql登錄驗證問題，新手，請大神們指教 C# Retry重試操作解決方案（附源碼） MicrosoftAgent技術在Delphi中的應用 Request.UrlReferrer 使用，request.urlreferrer poj 3208 Apocalypse Someday(數位dp)

欄目導航

C#ASP.NET 關於.NET .NET實例教程