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

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

[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该注意的重点都在说明注解里

<!--设定width为100%以刚好符合PDF文件的宽度-->
<!--如果width为固定宽度的话，C#那边可能要改写成Document doc = new Document(PageSize.A3)-->
<!--此table已调整好高度刚好符合PDF A4一页的高度了-->
<table style='width:100%;'  >
<tr >
<td colspan='2' style='color:#808080;'>
<h2>[厂商名称]</h2>
</td>
</tr>
<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>
</tr>

<tr>
<td  colspan='2'  style='text-align:center; height:90px;'><h1>XXX借用函证书</h1></td>
</tr>
<tr>
<td  colspan='2'  style='text-align:right;font-size:20px;'> 日期：民国[函证民国日期] </td>
</tr>
<tr>
<td  colspan='2'  style='height:10px;font-size:20px;' > 敬启者：[经销商全衔] </td>
</tr>
<tr>
<td  colspan='2'  style='height:30px;font-size:20px;'  > XXX 借用人：[员工姓名] </td>
</tr>
<tr>
<td  colspan='2'  style='height:50px;line-height:27px;font-size:20px;vertical-align:bottom;' > [厂商名称]将於 [存货盘点民国日期] 进行例行性存货盘点，恳请协助清点敝公司借予  贵公司之存货品名及数量是否与下列明细相符，并盖章回传以兹证明。 </td>
</tr>
<tr>
<td  colspan='2'  style='height:40px;font-size:20px;' > 敬祝  商祺 </td>
</tr>
<tr>
<td  colspan='2'  style='height:30px;line-height:20px;font-size:20px;' > 此致  [厂商名称] </td>
</tr>
<tr>
<td  colspan='2'  style='font-size:20px;line-height:20px;'  > 以下为截至 民国[函证民国日期] 为止，贵公司借用之存货明细：  </td>
</tr>
<tr>
<td  colspan='2'  style='height:280px;vertical-align:top;font-size:20px;'  >
<table  style='border:1px solid #000000; width:100%;' cellpadding='0' cellspacing='0'>
<tr>
<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>
</tr>
</table>

</td>
</tr>
<tr>
<td  colspan='2'  style='font-size:20px;' > 确认无误，特此证明。  </td>
</tr>
<tr>
<td  colspan='2'  style='height:200px; '      >
<div style='float:right;'>
<table style='border:1px solid #000000; ' cellpadding='0' cellspacing='0'>
<tr>
<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>
</tr>
</table>
</div>
</td>
</tr>
<tr>
<td  colspan='2'  style='text-align:right;font-size:20px;'  > 民国[函证民国日期] </td>
</tr>
<tr style='font-size:13px;height:50px;'>
<td  colspan='2'  style='color:#808080;font-size:16px; vertical-align:bottom;'   > 经销商代号: 出借者工号: </td>
</tr>
</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?