IronWord 中 SaveAs 后页眉消失

Updated: 2026年6月29日

请注意: 此行为仅在一个环境中被报告，且未得到IronWord更新日志的证实——其他IronWord指南均将SaveAs()作为标准的保存调用，且未报告页眉丢失问题。请将此视为可能与特定环境相关的异常，而非已确认的产品缺陷，并在应用下面的解决方法之前在您自己的环境中进行验证。

在某些环境中，当您使用IronWord填充DOCX模板并用SaveAs()写入结果时，模板的页眉可能会在生成的文件中消失，即使占位符合并正确。

Header (e.g. "City Attorney Cover Sheet") is visible in the original DOCX
but missing in the generated file after calling SaveAs().

Header (e.g. "City Attorney Cover Sheet") is visible in the original DOCX
but missing in the generated file after calling SaveAs().

Text

未替换占位符且无页眉的Word模板

在观察到此问题的环境中，使用Save()而非SaveAs()写入文档时，页眉得以保留。这一点尚未在其他环境或IronWord的更新日志中得到证实——其他IronWord指南均将SaveAs()作为标准的保存调用，且不存在页眉丢失问题，因此请将此视为特定于环境的情况，而非已确认的产品缺陷。

解决方案

1. 加载模板

用WordDocument打开源DOCX。

using IronWord;
using System.Collections.Generic;

var templatePath = @"C:\Templates\CityAttorneyCoverSheetTemplate.docx";
var outputPath   = @"C:\Output\merged.docx";

var doc = new WordDocument(templatePath);

using IronWord;
using System.Collections.Generic;

var templatePath = @"C:\Templates\CityAttorneyCoverSheetTemplate.docx";
var outputPath   = @"C:\Output\merged.docx";

var doc = new WordDocument(templatePath);

2. 替换占位符

通过doc.Texts合并您的值，这是一种直接的查找/替换方法；对于使用MERGEFIELD语法、占位符较多的模板，IronWord还提供了专用的WordDocument.MailMerge API。

var replacements = new Dictionary<string, string>
{
    ["{CaseNumber}"] = "2026-CR-12345",
    ["{DefendantName}"] = "John Doe",
    ["{DefendantAge}"] = "34",
    ["{DefendantAttorney}"] = "Jane Smith",
};

foreach (var kv in replacements)
{
    doc.Texts.ForEach(t => t.Replace(kv.Key, kv.Value));
}

var replacements = new Dictionary<string, string>
{
    ["{CaseNumber}"] = "2026-CR-12345",
    ["{DefendantName}"] = "John Doe",
    ["{DefendantAge}"] = "34",
    ["{DefendantAttorney}"] = "Jane Smith",
};

foreach (var kv in replacements)
{
    doc.Texts.ForEach(t => t.Replace(kv.Key, kv.Value));
}

遍历doc.Texts中的每个条目，将文档主体中的每个占位符标记替换为其合并值。