C#如何操作PDF表单填充数据_C#实现电子合同模版自动生成【方案】-C#.Net教程-PHP中文网

最稳方案是用 itext7 的 pdfdocument + acroform，正确嵌入中文字体、跳过签名域、调用 close() 保存；动态合同应先 html 渲染再转 pdf。

c#如何操作pdf表单填充数据_c#实现电子合同模版自动生成【方案】

用 iTextSharp 7 填充 PDF 表单字段最稳

直接结论：别碰 iTextSharp 5（已停止维护，.NET Core 不兼容），优先选 iText7 + itext.kernel.pdf.PdfDocument。它支持 AcroForm 和 XFA（有限），且能正确处理中文、数字签名预留位、只读字段等真实合同场景。

常见错误是用 PdfStamper （iText 5）强行写入 .NET 6+ 项目，结果字段值不显示、中文乱码、或生成的 PDF 被 Adobe Reader 拒绝验证签名。

安装 NuGet 包：itext7、itext7.kernel、itext7.layout（后者非必需，但填带格式文本时有用）
必须用 PdfReader 打开原始模板（不能用 FileStream 直接构造），否则表单字段元数据丢失
字段名区分大小写，且常含前缀如 form1[0].#subform[0].TextField1[0]（XFA）或简单如 contract_no（AcroForm），建议先用 pdfAcroForm.GetFieldNames() 打印出来确认

中文乱码？字体嵌入是硬性要求

PDF 表单字段默认使用 Helvetica，不支持中文。不嵌入中文字体，填充后显示为空白或方块——这不是编码问题，是字体缺失。

实操上必须做两件事：

加载一个支持中文的 TrueType 字体（如 simhei.ttf 或开源的 NotoSansCJKsc-Regular.otf），用 PdfFontFactory.CreateFont(fontPath, PdfEncodings.IDENTITY_H, true)
对每个要填中文的字段，调用 field.SetWidgetFontSize(12f) 后，再调用 field.SetWidgetFont(pdfFont)（注意：不是设置 field 的 Font 属性，而是 widget 的 font）
如果字段已有默认字体（比如模板里设了“黑体”），得先 field.RemoveWidget() 再 field.RefreshAppearance()，否则新字体不生效

电子合同关键：保留签名域并防止篡改

合同模板里通常有 Signature1 这类签名域。填充数据时若不小心覆盖或重绘该域，会导致后续无法签名，或签名后校验失败。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

安全做法是跳过所有类型为 PdfName.SIG 的字段：

var acroForm = pdfDoc.GetAcroForm();
foreach (string name in acroForm.GetFieldNames()) {
    var field = acroForm.GetField(name);
    if (field.GetFieldType() == PdfName.SIG) continue; // 忽略签名域
    if (field.GetValueAsString() != null) {
        field.SetValue("张三"); // 其他字段正常填
    }
}

另外，务必在保存前调用 pdfDoc.Close()（不是 Dispose），否则部分字段值可能未写入底层流；且保存时用 new PdfWriter(outputStream, new WriterProperties().SetFullCompressionMode(true))，避免因压缩破坏签名结构。