C#中使用OpenXML合并Word模板时页眉缺失或不匹配页面问题

核心问题分析 #

• 页眉与章节关联混乱：原代码将所有模板的页眉统一收集后批量添加，再给所有章节绑定全部页眉，导致每个章节都应用所有页眉，而非对应原模板的页眉。
• 页眉引用ID失效：原模板的SectionProperties中HeaderReference的ID指向原文档的部件，克隆到目标文档后这些ID已无效，无法关联新添加的页眉部件。
• 分节符逻辑错误：插入的分节符附带的章节属性是空白模板，没有继承原模板的页眉配置，导致新章节无对应页眉。

修正后的代码 #

using DocumentFormat.OpenXml;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
using System.Collections.Generic;
using System.IO;
using System.Linq;

public class OpenXmlMerging
{
    public void MergeTemplates(string targetFilePath, List<string> sourceFilePaths)
    {
        using (WordprocessingDocument targetDoc = WordprocessingDocument.Create(targetFilePath, WordprocessingDocumentType.Document))
        {
            MainDocumentPart mainPart = targetDoc.AddMainDocumentPart();
            mainPart.Document = new Document(new Body());

            foreach (var sourceFilePath in sourceFilePaths)
            {
                using (WordprocessingDocument sourceDoc = WordprocessingDocument.Open(sourceFilePath, false))
                {
                    // 1. 为当前模板添加页眉到目标文档，建立原URI到新ID的映射
                    var headerIdMap = AddTemplateHeadersToTarget(mainPart, sourceDoc.MainDocumentPart.HeaderParts);

                    // 2. 合并模板内容，并替换章节属性中的页眉引用ID
                    MergeTemplateBodyWithHeaderMapping(targetDoc, sourceDoc, headerIdMap);

                    // 3. 非最后一个模板时插入下一页分节符
                    if (sourceFilePath != sourceFilePaths.Last())
                    {
                        InsertNextPageSectionBreak(mainPart);
                    }
                }
            }

            mainPart.Document.Save();
        }
    }

    /// <summary>
    /// 将单个模板的页眉添加到目标文档，返回原页眉URI到新部件ID的映射
    /// </summary>
    private Dictionary<string, string> AddTemplateHeadersToTarget(MainDocumentPart targetMainPart, IEnumerable<HeaderPart> sourceHeaderParts)
    {
        var idMap = new Dictionary<string, string>();
        var existingIds = targetMainPart.Parts.Select(p => p.RelationshipId).ToList();

        foreach (var sourceHeader in sourceHeaderParts)
        {
            string sourceUri = sourceHeader.Uri.ToString();
            if (idMap.ContainsKey(sourceUri)) continue;

            // 生成唯一的部件ID
            string newId = GenerateUniqueRelationshipId(existingIds);
            existingIds.Add(newId);

            // 添加新页眉部件并复制内容
            var newHeaderPart = targetMainPart.AddNewPart<HeaderPart>(newId);
            using (var stream = sourceHeader.GetStream())
            {
                stream.CopyTo(newHeaderPart.GetStream());
            }

            idMap.Add(sourceUri, newId);
        }

        return idMap;
    }

    /// <summary>
    /// 合并模板内容，同时替换章节属性中的页眉引用ID为目标文档的新ID
    /// </summary>
    private void MergeTemplateBodyWithHeaderMapping(WordprocessingDocument targetDoc, WordprocessingDocument sourceDoc, Dictionary<string, string> headerIdMap)
    {
        var sourceBody = sourceDoc.MainDocumentPart.Document.Body;
        var targetBody = targetDoc.MainDocumentPart.Document.Body;

        foreach (var element in sourceBody.Elements())
        {
            var clonedElement = element.CloneNode(true);

            // 处理章节属性中的页眉引用
            if (clonedElement is SectionProperties sectionProps)
            {
                foreach (var headerRef in sectionProps.Elements<HeaderReference>().ToList())
                {
                    var sourceHeaderPart = sourceDoc.MainDocumentPart.GetPartById(headerRef.Id);
                    if (sourceHeaderPart is HeaderPart sourceHeader)
                    {
                        string sourceUri = sourceHeader.Uri.ToString();
                        if (headerIdMap.TryGetValue(sourceUri, out string newId))
                        {
                            headerRef.Id = newId;
                        }
                    }
                }
            }

            targetBody.Append(clonedElement);
        }
    }

    /// <summary>
    /// 插入下一页分节符，继承上一章节的页面设置
    /// </summary>
    private void InsertNextPageSectionBreak(MainDocumentPart mainPart)
    {
        var lastSectionProps = mainPart.Document.Body.Elements<SectionProperties>().LastOrDefault();

        // 继承上一章节的页面大小和边距，避免格式突变
        var pageSize = lastSectionProps?.Elements<PageSize>().FirstOrDefault()?.CloneNode(true) ?? new PageSize { Width = 12240, Height = 15840 };
        var pageMargin = lastSectionProps?.Elements<PageMargin>().FirstOrDefault()?.CloneNode(true) ?? new PageMargin { Top = 1440, Bottom = 1440, Left = 1440, Right = 1440 };

        var sectionProps = new SectionProperties(
            new SectionType { Val = SectionMarkValues.NextPage },
            pageSize,
            pageMargin
        );

        mainPart.Document.Body.Append(new Paragraph(new Run(new Break { Type = BreakValues.Page })));
        mainPart.Document.Body.Append(sectionProps);
    }

    /// <summary>
    /// 生成唯一的部件关联ID
    /// </summary>
    private string GenerateUniqueRelationshipId(IEnumerable<string> existingIds)
    {
        int i = 1;
        while (true)
        {
            string id = $"rId{i}";
            if (!existingIds.Contains(id)) return id;
            i++;
        }
    }
}

关键修改说明 #

• 按模板独立处理页眉：每个模板的页眉单独添加到目标文档，即时建立映射关系，避免全局混乱。
• 修复页眉引用映射：克隆原模板章节属性后，将其中的页眉引用ID替换为目标文档的新ID，确保引用有效。
• 继承式分节符：插入分节符时继承上一章节的页面设置，避免格式突变，同时保证每个模板内容对应独立章节。

内容的提问来源于stack exchange，提问作者Asad Moosa