Class MailMergeOptions
Namespace: Aspose.Words.LowCode
Assembly: Aspose.Words.dll
表示邮件合并功能的选项。
public class MailMergeOptions继承
继承成员
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
构造函数
MailMergeOptions()
public MailMergeOptions()属性
CleanupOptions
获取或设置一组标志，指定在邮件合并过程中应删除哪些项目。
public MailMergeCleanupOptions CleanupOptions { get; set; }属性值
CleanupParagraphsWithPunctuationMarks
获取或设置一个值，指示带有标点符号的段落是否被视为空，并且如果指定了 Aspose.Words.MailMerging.MailMergeCleanupOptions.RemoveEmptyParagraphs 选项，则应删除这些段落。
public bool CleanupParagraphsWithPunctuationMarks { get; set; }属性值
备注
默认值为 true。
MergeDuplicateRegions
获取或设置一个值，指示在执行与数据源的区域邮件合并时，是否应合并所有具有数据源名称的文档邮件合并区域，还是仅合并第一个。
public bool MergeDuplicateRegions { get; set; }属性值
备注
默认值为 false。
MergeWholeDocument
获取或设置一个值，指示在执行区域邮件合并时，整个文档中的字段是否会被更新。
public bool MergeWholeDocument { get; set; }属性值
备注
默认值为 false。
PreserveUnusedTags
获取或设置一个值，指示是否应保留未使用的“胡子”标签。
public bool PreserveUnusedTags { get; set; }属性值
备注
默认值为 false。
另请参见
MailMergeOptions.UseNonMergeFields
RegionEndTag
获取或设置邮件合并区域结束标签。
public string RegionEndTag { get; set; }属性值
RegionStartTag
获取或设置邮件合并区域开始标签。
public string RegionStartTag { get; set; }属性值
RestartListsAtEachSection
获取或设置一个值，指示在执行邮件合并后，列表是否在每个部分重新开始。
public bool RestartListsAtEachSection { get; set; }属性值
备注
默认值为 true。
RetainFirstSectionStart
获取或设置一个值，指示在邮件合并过程中，是否保留第一个文档部分的部分开始及其后续数据源行的副本，还是根据 MS Word 的行为进行更新。
public bool RetainFirstSectionStart { get; set; }属性值
备注
默认值为 true。
TrimWhitespaces
获取或设置一个值，指示是否从邮件合并值中修剪前导和尾随空格。
public bool TrimWhitespaces { get; set; }属性值
备注
默认值为 true。
UnconditionalMergeFieldsAndRegions
获取或设置一个值，指示是否无条件合并字段和合并区域，而不考虑父 IF 字段的条件。
public bool UnconditionalMergeFieldsAndRegions { get; set; }属性值
备注
默认值为 false。
UseNonMergeFields
当 true 时，指定除了 MERGEFIELD 字段外，邮件合并还应执行到其他类型的字段以及 “{{fieldName}}” 标签。
public bool UseNonMergeFields { get; set; }属性值
备注
通常，邮件合并仅在 MERGEFIELD 字段中执行，但一些客户使用其他字段构建了他们的报告，并以这种方式创建了许多文档。为了简化迁移（并且因为这种方法被几个客户独立使用），引入了在其他字段中执行邮件合并的能力。
当 Aspose.Words.LowCode.MailMergeOptions.UseNonMergeFields 设置为 true 时，Aspose.Words 将在以下字段中执行邮件合并：
MERGEFIELD FieldName
MACROBUTTON NOMACRO FieldName
IF 0 = 0 "{FieldName}" ""
此外，当 Aspose.Words.LowCode.MailMergeOptions.UseNonMergeFields 设置为 true 时，Aspose.Words 将在文本标签 "{{fieldName}}" 中执行邮件合并。这些不是字段，而只是文本标签。
UseWholeParagraphAsRegion
获取或设置一个值，指示带有 TableStart 或 TableEnd 字段的整个段落或特定范围（在 TableStart 和 TableEnd 字段之间）是否应包含在邮件合并区域中。
public bool UseWholeParagraphAsRegion { get; set; }属性值
备注
默认值为 true。
