ASP.NET MVC中iTextSharp 5.5.13转PDF时表单控件不渲染问题

我之前在ASP.NET MVC项目里用iTextSharp转HTML到PDF时，也踩过和你一模一样的坑——网页里的表单控件（文本框、单选框这些）在浏览器里显示正常，但转成PDF后就只剩标签和图片，其他控件全没了。这其实是因为iTextSharp对HTML原生表单元素的支持非常有限，默认情况下它不会把这些元素转换成PDF里的可视化控件，要么直接忽略，要么只提取文本内容。

下面给你两种解决方案，根据你是否需要PDF里的表单可交互来选：

方案一：把表单控件转成静态可视化元素（适合不需要交互的PDF） #

如果你的PDF只是用来展示内容，不需要用户在PDF里填写表单，那可以把HTML里的表单控件替换成模拟样式的静态元素，让iTextSharp能正常渲染：

• 文本框：把<input type="text" value="你的内容">替换成带边框的<div>或<span>，比如：

  <span style="border:1px solid #000; padding:2px 4px;">你的内容</span>
  

• 单选按钮：根据checked状态，用●（选中）或○（未选中）符号代替，比如：

  <!-- 选中状态 -->
  <span>● 选项A</span>
  <!-- 未选中状态 -->
  <span>○ 选项B</span>
  

• 复选框：用☑️（选中）或☐（未选中）符号代替，比如：

  <!-- 选中状态 -->
  <span>☑️ 同意条款</span>
  <!-- 未选中状态 -->
  <span>☐ 接收通知</span>
  

• 下拉框：直接显示选中的文本，加上下拉箭头符号模拟样式：

  <span>选中选项 ▼</span>
  

• 日历控件：显示选中的日期文本，不需要保留控件样式：

  <span>2024-05-20</span>
  

你可以用HtmlAgilityPack来批量替换这些元素，比如遍历HTML节点，根据标签类型和属性替换成对应的静态内容，再把处理后的HTML传给iTextSharp。

方案二：手动添加可交互的PDF表单控件（需要交互的PDF） #

如果你的PDF需要用户能填写表单，那不能依赖HTML转译，得先渲染静态内容，再手动添加PDF原生的表单控件：

步骤1：用XmlWorker渲染HTML里的静态内容 #

首先用XmlWorker把HTML中的标签、图片等静态内容渲染到PDF文档里（注意iTextSharp 5.5.13推荐用XmlWorker，过时的HTMLWorker功能更有限）：

public FileResult Export(string GridHtml)
{
    using (MemoryStream ms = new MemoryStream())
    {
        Document document = new Document();
        PdfWriter writer = PdfWriter.GetInstance(document, ms);
        document.Open();

        // 先渲染静态HTML内容
        using (StringReader sr = new StringReader(GridHtml))
        {
            XmlWorkerHelper.GetInstance().ParseXHtml(writer, document, sr);
        }

        // 接下来手动添加表单控件...
        document.Close();
        return File(ms.ToArray(), "application/pdf", "Exported.pdf");
    }
}

步骤2：解析HTML表单元素，添加PDF表单控件 #

你需要用HtmlAgilityPack解析传入的GridHtml，提取表单元素的位置、名称、值等信息，然后用iTextSharp的表单API创建对应的控件：

比如添加文本框：

// 获取PDF的AcroForm
AcroForm form = writer.AcroForm;

// 解析HTML中的文本框
HtmlDocument htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(GridHtml);
var textInputs = htmlDoc.DocumentNode.SelectNodes("//input[@type='text']");

foreach (var input in textInputs)
{
    // 这里需要计算控件在PDF中的位置（可以通过HTML元素的位置转换，或者预设坐标）
    // 示例：创建一个文本框，坐标需要根据你的布局调整
    TextField textField = new TextField(writer, new Rectangle(100, 700, 300, 720), input.GetAttributeValue("name", ""));
    textField.Text = input.GetAttributeValue("value", "");
    form.AddField(textField.GetTextField());
}

单选按钮、复选框、下拉框的创建逻辑类似，分别用RadioCheckField和ListField等类来实现。不过这里的难点是HTML元素到PDF坐标的转换，因为iTextSharp不会给你返回HTML元素在PDF中的位置，你可能需要预设布局，或者用CSS来控制位置，再对应到PDF的坐标体系。

注意事项 #

• 确保你用的是XmlWorker而不是过时的HTMLWorker，HTMLWorker对表单元素的支持几乎为零；
• 如果用静态替换的方式，要注意CSS样式的兼容性，iTextSharp支持的CSS有限，复杂样式可能渲染异常；
• 手动添加表单控件时，PDF的坐标体系是左下角为原点，和HTML的左上角原点相反，计算坐标时要注意转换。

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