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);

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