[ASP.net MVC] 将HTML转成PDF档案，使用iTextSharp套件的XMLWorkerHelper (附上解决显示中文问题)-阿里云开发者社区

link之家

链接快照平台

输入网页链接，自动生成快照
标签化管理网页链接

[ASP.net MVC] 将HTML转成PDF档案，使用iTextSharp套件的XMLWorkerHelper (附上解决显示中文问题)

最近专案又遇到需要制作PDF文件的需求，这次还要额外控制PDF档案的其他功能，我的直觉马上联想到使用iTextSharp来实现

一般使用iTextSharp套件要塞资料到PDF档案里的话，大概要先把Phrase、PdfPTable、PdfPCell……等等几个物件叫出来，然後加入至Document物件

※请参考其他网友文章：使用ASP .NET (C#) 产生PDF档的好帮手—iTextSharp library (上) 、使用ASP .NET (C#) 产生PDF档的好帮手—iTextSharp library (下)

但由於专案要求有 [网页预览+下载PDF(把预览的网页画面转出到PDF档)功能]

因为已经先有Html网页画面了，我比较懒，所以在网路上寻求有没有把Html网页转PDF档的iTextSharp实现办法

虽然过程中有考量用： [ASP.net MVC] 在Web专案上使用Pechkin套件将网页转成PDF档

但Pechkin没办法进一步控制PDF档案的详细功能，它只能仅仅印出来而已

所以整个需求大致是： 利用iTextSharp套件将网页档(或HTML文字)转成PDF档

而iTextSharp一般在网路上比较常见，都是使用内建的HtmlWorker物件来实现

※HtmlWorker已有中文字显示问题的解决办法，请参考其他网友文章：使用iTextSharp 5将html档转成PDF档

但本文使用的是XMLWorkerHelper物件来Parse网页Html文字

因为比起HtmlWorker物件，XMLWorkerHelper类别支援更多CSS和Html标签(例如<hr/>)，但缺点预设不支援中文字

不过中文字显示问题，已经在下文的Sample Code中解决了

先为Web专案透过NuGet加入以下参考

以下是要输出成PDF档案的范例静态网页内容，还没套程式，因为套程式塞资料到画面不是本文的重点

此网页Html该注意的重点都在说明注解里

<table style='width:100%;' > <td colspan='2' style='color:#808080;'> <h2>[厂商名称]</h2> <tr style='font-size:13px;'> <td style='width:600px;color:#808080;font-size:16px;'>Taiwan Limited<br />4F,144 Changchun Rd., Taipei 104, Taiwan</td> <td style='width:80%;color:#808080;font-size:16px;text-align:right;'>[页码]/[总页数]</td> <td colspan='2' style='text-align:center; height:90px;'><h1>XXX借用函证书</h1></td> <td colspan='2' style='text-align:right;font-size:20px;'> 日期：民国[函证民国日期] </td> <td colspan='2' style='height:10px;font-size:20px;' > 敬启者：[经销商全衔] </td> <td colspan='2' style='height:30px;font-size:20px;' > XXX 借用人：[员工姓名] </td> <td colspan='2' style='height:50px;line-height:27px;font-size:20px;vertical-align:bottom;' > [厂商名称]将於 [存货盘点民国日期] 进行例行性存货盘点，恳请协助清点敝公司借予  贵公司之存货品名及数量是否与下列明细相符，并盖章回传以兹证明。 </td> <td colspan='2' style='height:40px;font-size:20px;' > 敬祝  商祺 </td> <td colspan='2' style='height:30px;line-height:20px;font-size:20px;' > 此致  [厂商名称] </td> <td colspan='2' style='font-size:20px;line-height:20px;' > 以下为截至民国[函证民国日期] 为止，贵公司借用之存货明细： </td> <td colspan='2' style='height:280px;vertical-align:top;font-size:20px;' > <table style='border:1px solid #000000; width:100%;' cellpadding='0' cellspacing='0'> <td style='border:1px solid #000000;text-align:center;font-size:20px;'>No</td> <td style='border:1px solid #000000;text-align:center;font-size:20px;'>品号</td> <td style='border:1px solid #000000;text-align:center;font-size:20px;'>品名</td> <td style='border:1px solid #000000;text-align:center;font-size:20px;'>数量</td> </table> <td colspan='2' style='font-size:20px;' > 确认无误，特此证明。 </td> <td colspan='2' style='height:200px; ' > <div style='float:right;'> <table style='border:1px solid #000000; ' cellpadding='0' cellspacing='0'> <td style='border:1px solid #000000;width:180px;height:180px;text-align:right; vertical-align:bottom;padding-bottom:10px;font-size:16px;'>经销商公司章</td> <td style='border:1px solid #000000;width:180px;height:180px;text-align:right;vertical-align:bottom;padding-bottom:10px;font-size:16px;'>借用人签章</td> </table> <td colspan='2' style='text-align:right;font-size:20px;' > 民国[函证民国日期] </td> <tr style='font-size:13px;height:50px;'> <td colspan='2' style='color:#808080;font-size:16px; vertical-align:bottom;' > 经销商代号: 出借者工号: </td> </table>

该Html静态网页的执行内容

※补充说明，以上最外层的table容器宽度如果是固定宽度而非100%宽，Document物件又设为PageSize.A4的话，输出成PDF很可能会变这样↓

↑这种情况虽然调参数Document doc=new Document(PageSize.A3);即可解决，但比较通用的办法还是把最外层的容器宽度设为100%以符合PDF各种A4 、A3大小的宽度

接下来在专案中加入一个自订类别UnicodeFontFactory.cs，待会输出PDF时要使用此类别来解决XMLWorkerHelper不支援中文字问题

UnicodeFontFactory.cs代码完整内容

using iTextSharp.text;
using iTextSharp.text.pdf;
using iTextSharp.tool.xml;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;
using System.Web;
    public class UnicodeFontFactory : FontFactoryImp 
        private static readonly string arialFontPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Fonts),
            "arialuni.ttf");//arial unicode MS是完整的unicode字型。
        private static readonly string 标楷体Path = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Fonts),
          "KAIU.TTF");//标楷体
        public override Font GetFont(string fontname, string encoding, bool embedded, float size, int style, BaseColor color,
            bool cached)
            //可用Arial或标楷体，自己选一个
            BaseFont baseFont = BaseFont.CreateFont(标楷体Path, BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
            return new Font(baseFont, size, style, color);
而在HomeController里，Html转PDF的完整范例代码
using iTextSharp.text;
using iTextSharp.text.pdf;
using iTextSharp.tool.xml;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Net;
using System.Text;
using System.Web;
using System.Web.Mvc;
namespace MvcApplicationPDF.Controllers
    public class HomeController : Controller
        /// <summary>
        /// 执行此Url，下载PDF档案
        /// </summary>
        /// <returns></returns>
        public ActionResult DownloadPdf()
            WebClient wc = new WebClient();
            //从网址下载Html字串
            string htmlText = wc.DownloadString("http://localhost:3056/Preview.html");
            byte[] pdfFile = this.ConvertHtmlTextToPDF(htmlText);
            return File(pdfFile, "application/pdf", "范例PDF档.pdf");
        /// <summary>
        /// 将Html文字 输出到PDF档里
        /// </summary>
        /// <param name="htmlText"></param>
        /// <returns></returns>
        public  byte[] ConvertHtmlTextToPDF(string htmlText)
            if (string.IsNullOrEmpty(htmlText))
                return null;
            //避免当htmlText无任何html tag标签的纯文字时，转PDF时会挂掉，所以一律加上<p>标签
            htmlText = "<p>" + htmlText + "</p>";
            MemoryStream outputStream = new MemoryStream();//要把PDF写到哪个串流
            byte[] data = Encoding.UTF8.GetBytes(htmlText);//字串转成byte[]
            MemoryStream msInput = new MemoryStream(data);
            Document doc = new Document();//要写PDF的文件，建构子没填的话预设直式A4
            PdfWriter writer = PdfWriter.GetInstance(doc, outputStream);
            //指定文件预设开档时的缩放为100%
            PdfDestination pdfDest = new PdfDestination(PdfDestination.XYZ, 0, doc.PageSize.Height, 1f);
            //开启Document文件 
            doc.Open();
            //使用XMLWorkerHelper把Html parse到PDF档里
            XMLWorkerHelper.GetInstance().ParseXHtml(writer, doc, msInput, null, Encoding.UTF8, new UnicodeFontFactory());
            //将pdfDest设定的资料写到PDF档
            PdfAction action = PdfAction.GotoLocalPage(1, pdfDest, writer);
            writer.SetOpenAction(action);
            doc.Close();
            msInput.Close();
            outputStream.Close();
            //回传PDF档案 
            return outputStream.ToArray();
执行结果：
将Html转成PDF，使用Pechkin或iTextSharp各有优缺点
画面呈现当然是Pechkin比较忠於原始网页(因为采用Webkit引擎)，如果没要进一步控制PDF档案功能的话，可使用Pechkin
如果要进一步控制PDF功能而且画面只是单纯的白纸黑字，就可以改用iTextSharp套件
Display Unicode characters in converting Html to Pdf
How to set a default zoom percent to “100%” using iTextSharp 4.0.2? 
                《Servlet、JSP和Spring MVC初学指南》——1.10　处理HTML表单
            复选框比较奇特。核查过的复选框会发送字符串“on”到服务器。未经核查的复选框则不向服务器发送任何内容，ServletRequest.getParameter(fieldName)返回null。