在 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合併您的值，這是範本取代的建議方法。

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上迭代每個條目，將文件主體中的每個佔位符標記交換為其合併值。