使用iTextSharp将HTML转换为PDF时如何修改字体族、字号与内边距

你当前用的导出逻辑基于iTextSharp旧版HTMLWorker解析组件，这个组件是早已停更的旧版本，对CSS样式的支持能力非常弱，根本读不到ASP.NET Panel、GridView上配置的字体、内边距、字号样式，按下面的步骤调整就能直接实现自定义样式需求。

1. 替换低能力的HTML解析组件 #

老旧的HTMLWorker仅能识别非常基础的HTML标签属性，完全无法解析自定义CSS，直接换用iTextSharp内置的XMLWorker组件即可实现样式解析能力，原有导出流程不需要大改，仅需调整解析逻辑：

注意：XMLWorker是iTextSharp的内置配套组件，你当前项目引用的iTextSharp安装包中已经携带了对应dll，只需要在代码顶部引入iTextSharp.tool.xml命名空间即可，不需要额外下载第三方依赖。

' 1. 定义你需要的全局自定义样式，用标准CSS语法编写即可
Dim customStyleRules As String = "
    body { font-family: SimSun; font-size: 12px; }
    table { border-collapse: collapse; width: 100%; }
    th, td { padding: 6px 8px; border: 1px solid #ccc; font-size: 12px; }
    .pnl-content { padding: 10px; }
"

' 2. 把自定义样式和Panel渲染出的HTML内容拼接成完整的解析源
Dim panelRenderedHtml As String = sw.ToString()
Dim fullParseContent As String = $"<style>{customStyleRules}</style>{panelRenderedHtml}"
Dim sr As New StringReader(fullParseContent)

' 3. 替换原有HTMLWorker的解析逻辑
Dim pdfParser As XMLWorkerHelper = XMLWorkerHelper.GetInstance()
pdfParser.ParseXHtml(pdfDoc, sr)

2. 解决自定义字体不生效的问题 #

iTextSharp默认无法识别系统字体库，仅靠CSS里写字体名不会生效，需要提前把目标字体注册到iTextSharp的字体工厂中：

' 注册本地系统字体（示例为宋体、微软雅黑）
Dim fontDir As String = Environment.GetFolderPath(Environment.SpecialFolder.Fonts)
FontFactory.Register(Path.Combine(fontDir, "simsun.ttc"), "SimSun")
FontFactory.Register(Path.Combine(fontDir, "msyh.ttc"), "MicrosoftYaHei")

如果项目要部署到无图形界面的服务器上，建议把需要的字体文件拷贝到项目的静态资源目录下，直接从项目路径读取注册，避免因为服务器缺失字体文件导致导出乱码。

3. 原有导出流程的细节修正 #

• 原代码中冗余的Response.Write(pdfDoc)可以直接删除，因为PdfWriter.GetInstance已经将PDF内容直接写入Response的输出流，重复写回会导致PDF文件损坏无法打开。
• 如果导出时遇到“控件必须放在具有 runat=server 的窗体内”的报错，只需要在当前页面类里重写VerifyRenderingInServerForm方法，留空方法体即可绕过校验，不影响导出逻辑。
• 如果你坚持不替换原有HTMLWorker组件，只能通过字符串正则替换的方式，把Panel渲染出的HTML里所有td、th标签手动加上内联的font-size、padding属性，再传给解析器，这种方式灵活性差，遇到嵌套表格很容易替换出错，不推荐长期使用。

内容的提问来源于stack exchange，提问作者Karrie