MailMergeRegionInfo

MailMergeRegionInfo class

包含有关邮件合并区域的信息。

要了解更多信息,请访问邮件合并和报告文档文章。

public class MailMergeRegionInfo

特性

姓名描述
EndField { get; }返回区域的结束字段。
EndMustacheTag { get; }返回该区域的结束“mustache”标签。
Fields { get; }返回子字段列表。
Level { get; }返回区域的嵌套级别。
MustacheTags { get; }返回子“mustache”标签的列表。
Name { get; }返回区域名称。
ParentRegion { get; }返回父区域信息(顶级区域为空)。
Regions { get; }返回子区域列表。
StartField { get; }返回区域的起始字段。
StartMustacheTag { get; }返回该区域的开始“mustache”标签。

例子

演示如何验证邮件合并区域。

Document doc = new Document(MyDir + "Mail merge regions.docx");

// 返回包含文档中可用的 MERGEFIELD 的合并区域的完整层次结构。
MailMergeRegionInfo regionInfo = doc.MailMerge.GetRegionsHierarchy();

// 获取文档中的顶部区域。
IList<MailMergeRegionInfo> topRegions = regionInfo.Regions;

Assert.AreEqual(2, topRegions.Count);
Assert.AreEqual("Region1", topRegions[0].Name);
Assert.AreEqual("Region2", topRegions[1].Name);
Assert.AreEqual(1, topRegions[0].Level);
Assert.AreEqual(1, topRegions[1].Level);

// 获取第一个顶部区域中的嵌套区域。
IList<MailMergeRegionInfo> nestedRegions = topRegions[0].Regions;

Assert.AreEqual(2, nestedRegions.Count);
Assert.AreEqual("NestedRegion1", nestedRegions[0].Name);
Assert.AreEqual("NestedRegion2", nestedRegions[1].Name);
Assert.AreEqual(2, nestedRegions[0].Level);
Assert.AreEqual(2, nestedRegions[1].Level);

// 获取第一个顶部区域内的字段列表。
IList<Field> fieldList = topRegions[0].Fields;

Assert.AreEqual(4, fieldList.Count);

FieldMergeField startFieldMergeField = nestedRegions[0].StartField;

Assert.AreEqual("TableStart:NestedRegion1", startFieldMergeField.FieldName);

FieldMergeField endFieldMergeField = nestedRegions[0].EndField;

Assert.AreEqual("TableEnd:NestedRegion1", endFieldMergeField.FieldName);

也可以看看