OdsoRecipientData

OdsoRecipientData class

表示有关外部数据源中要从邮件合并中排除的单个记录的信息。

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

public class OdsoRecipientData

构造函数

姓名	描述
OdsoRecipientData()	默认构造函数。

特性

姓名	描述
Active { get; set; }	指定执行邮件合并时是否将数据源中的记录导入到文档中。 默认值为真的.
Column { get; set; }	指定数据源中包含当前记录的唯一数据的列。 默认值为 0。
Hash { get; set; }	表示该记录的哈希码。 有时 Microsoft Word 使用Hash整个记录而不是UniqueTag值. 默认值为 0.
UniqueTag { get; set; }	指定包含唯一数据的列中给定记录的内容。 默认值为无效的.

方法

姓名	描述
Clone()	返回此对象的深度克隆。

评论

如果记录应合并到合并文档中，则不需要有关该记录的信息。 但是，如果给定记录不应合并到合并文档中，则该记录的唯一键 的值应存储在UniqueTag该对象的属性来指示此排除。

例子

显示如何访问指定邮件合并将排除哪些合并数据源记录的数据集合。

Document doc = new Document(MyDir + "Odso data.docx");

OdsoRecipientDataCollection dataCollection = doc.MailMergeSettings.Odso.RecipientDatas;

Assert.AreEqual(70, dataCollection.Count);

using (IEnumerator<OdsoRecipientData> enumerator = dataCollection.GetEnumerator())
{
    int index = 0;
    while (enumerator.MoveNext())
    {
        Console.WriteLine(
            $"Odso recipient data index {index++} will {(enumerator.Current.Active ? "" : "not ")}be imported upon mail merge.");
        Console.WriteLine($"\tColumn #{enumerator.Current.Column}");
        Console.WriteLine($"\tHash code: {enumerator.Current.Hash}");
        Console.WriteLine($"\tContents array length: {enumerator.Current.UniqueTag.Length}");
    }
}

// 我们可以克隆这个集合中的元素。
Assert.AreNotEqual(dataCollection[0], dataCollection[0].Clone());

// 我们还可以单独删除元素，或者一次性清除整个集合。
dataCollection.RemoveAt(0);

Assert.AreEqual(69, dataCollection.Count);

dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

也可以看看

• 命名空间 Aspose.Words.Settings
• 部件 Aspose.Words