程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> .NET網頁編程 >> ASP.NET >> ASP.NET基礎 >> 詳解開源免費且穩定實用的.NET PDF打印組件itextSharp(.NET組件介紹之八)

詳解開源免費且穩定實用的.NET PDF打印組件itextSharp(.NET組件介紹之八)

編輯:ASP.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()方法:打開文檔對象。

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組件的相關信息,在這個系列的組件介紹中,對於組件的介紹都是比較的簡單,旨在向大家介紹這個組件,在實際的開發中,我們可以根據實際情況自行選擇相應的組件,組件沒有絕對的好壞,只有合適的場景。

以上講解若有錯誤和不足之處,希望大家多多見諒和多多提出意見和建議。也希望大家多多支持腳本之家。

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved