C#中使用Aspose实现Word邮件合并表头与数据行交替输出的方法

1. 修改Word模板结构 #

原模板将表头行和数据行设为两个独立的顶级区域，导致先输出所有表头再输出所有数据。需调整为嵌套区域结构，让每组表头与对应数据绑定为一个重复单元：

• 保留表格两行结构，移除原表头行的{MERGEFIELD TableStart:Heading}和{MERGEFIELD TableEnd:Heading}，直接绑定tableHeader的字段（比如{MERGEFIELD h_Town}、{MERGEFIELD h_SD}）
• 在表格第一行的第一个单元格开头添加{MERGEFIELD TableStart:HeaderGroups}，在第二行的最后一个单元格末尾添加{MERGEFIELD TableEnd:HeaderGroups}
• 数据行保留原有的{MERGEFIELD TableStart:Parcels}和{MERGEFIELD TableEnd:Parcels}，作为HeaderGroups区域的子区域

最终模板表格结构示例：

2. 调整数据绑定代码 #

无需修改原有dt、tableHeader、tableData的数据填充逻辑，只需调整DataSet的表名和关联关系，匹配模板的嵌套区域：

DataSet dataSet = new DataSet();
// 给表头表命名，与模板父区域名称一致
tableHeader.TableName = "HeaderGroups";
tableData.TableName = "Parcels";
dataSet.Tables.Add(tableHeader);
dataSet.Tables.Add(tableData);
// 建立主表与子表的关联（h_SBL和t_SBL为关联字段）
dataSet.Relations.Add("HeaderGroups_Parcels", 
    tableHeader.Columns["h_SBL"], 
    tableData.Columns["t_SBL"]);

// 先处理普通邮件合并字段
template.MailMerge.Execute(dt);
// 执行嵌套区域的邮件合并，自动实现表头+数据的交替输出
template.MailMerge.ExecuteWithRegions(dataSet);
template.Save(outStream, Aspose.Words.SaveFormat.Docx);

3. 原理说明 #

修改后，Aspose.Words会遍历HeaderGroups父区域的每一条数据：先输出当前表头行，再输出该表头对应的所有Parcels子区域数据行，从而自然实现表头行→数据行→表头行→数据行的交替效果，替代了原有的独立区域批量输出逻辑。

内容的提问来源于stack exchange，提问作者Jonathan Small