C如何操作PDF表单填充数据_C实现电子合同模版自动生成【方案】

科技前沿 • 2026-04-30 08:29 • 阅读 0

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

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

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

直接结论：别碰 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 这类签名域。填充数据时若不小心覆盖或重绘该域，会导致后续无法签名，或签名后校验失败。

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

var acroForm = pdfDoc.GetAcroForm(); foreach (string name in acroForm.GetFieldNames()) }

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

纯 PDF 填充适合字段固定、逻辑简单的合同；一旦涉及条款折叠、条件条款（如“若选择服务A，则显示附件2”）、多页表格动态增行，硬填 AcroForm 会迅速失控。

更可持续的方案是：

用 Razor 或 Handlebars.Net 渲染 HTML 模板（支持 if/each/自定义函数）
用 QuestPDF 或 Wkhtmltopdf（封装为 HTTP 服务）转成 PDF
转出后，再用 iText7 加盖时间戳或插入数字签名域（PdfSigner）

这样业务逻辑在 C# 里写，模板可热更新，审计也方便——PDF 填充只是最后一步，不是主干。

C如何操作PDF表单填充数据_C实现电子合同模版自动生成【方案】

相关推荐