UnconditionalMergeFieldsAndRegions

MailMerge.UnconditionalMergeFieldsAndRegions property

获取或设置一个值，该值指示合并字段和合并区域是否合并，无论父 IF 字段的条件如何。

public bool UnconditionalMergeFieldsAndRegions { get; set; }

评论

默认值为错误的.

例子

显示如何合并字段或区域，而不管父 IF 字段的条件如何。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// 插入嵌套在 IF 字段内的 MERGEFIELD。
// 由于IF字段语句为假，因此不会显示MERGEFIELD的结果。
// MERGEFIELD 在邮件合并期间也不会接收任何数据。
FieldIf fieldIf = (FieldIf)builder.InsertField(" IF 1 = 2 ");
builder.MoveTo(fieldIf.Separator);
builder.InsertField(" MERGEFIELD  FullName ");

// 如果我们将“UnconditionalMergeFieldsAndRegions”标志设置为“true”，
// 我们的邮件合并会将数据插入到非显示字段中，例如我们的 MERGEFIELD 以及所有其他字段。
// 如果我们将“UnconditionalMergeFieldsAndRegions”标志设置为“false”，
// 我们的邮件合并不会将数据插入到被带有虚假语句的 IF 字段隐藏的 MERGEFIELD 中。
doc.MailMerge.UnconditionalMergeFieldsAndRegions = countAllMergeFields;

DataTable dataTable = new DataTable();
dataTable.Columns.Add("FullName");
dataTable.Rows.Add("James Bond");

doc.MailMerge.Execute(dataTable);

doc.Save(ArtifactsDir + "MailMerge.UnconditionalMergeFieldsAndRegions.docx");

Assert.AreEqual(
    countAllMergeFields
        ? "\u0013 IF 1 = 2 \"James Bond\"\u0014\u0015"
        : "\u0013 IF 1 = 2 \u0013 MERGEFIELD  FullName \u0014«FullName»\u0015\u0014\u0015",
    doc.GetText().Trim());

也可以看看

MailMerge.TrimWhitespaces MailMerge.UseNonMergeFields