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

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

OdsoFieldMappingType Enum OdsoRecipientDataCollection Class