OdsoRecipientData

OdsoRecipientData class

Представляет информацию об одной записи во внешнем источнике данных, которая должна быть исключена из слияния почты.

Чтобы узнать больше, посетитеСлияние почты и отчетность статья документации.

public class OdsoRecipientData

Конструкторы

ИмяОписание
OdsoRecipientData()Конструктор по умолчанию.

Характеристики

ИмяОписание
Active { get; set; }Указывает, должна ли запись из источника данных быть импортирована в документ при выполнении слияния почты. Значение по умолчанию:истинный .
Column { get; set; }Указывает столбец в источнике данных, который содержит уникальные данные для текущей записи. Значение по умолчанию: 0.
Hash { get; set; }Представляет хэш-код этой записи. Иногда Microsoft Word используетHash всей записи вместоUniqueTag value. Значение по умолчанию — 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);

Смотрите также