OdsoFieldMapData

OdsoFieldMapData class

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

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

public class OdsoFieldMapData

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

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

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

ИмяОписание
Column { get; set; }Указывает отсчитываемый от нуля индекс столбца во внешнем источнике данных, который должен быть сопоставлен с локальным именем определенного поля MERGEFIELD. Значение по умолчанию — 0.
MappedName { get; set; }Указывает предопределенное имя поля слияния, которое должно быть сопоставлено с номером столбца , указаннымColumn свойство в этом сопоставлении полей. Значение по умолчанию — пустая строка.
Name { get; set; }Указывает имя столбца во внешнем источнике данных для столбца, индекс которого указан вColumnproperty. Значение по умолчанию — пустая строка.
Type { get; set; }Указывает, сопоставлено ли данное поле слияния почты со столбцом в данном внешнем источнике данных или нет. Значение по умолчанию:Default .

Методы

ИмяОписание
Clone()Возвращает глубокую копию этого объекта.

Примечания

Microsoft Word предоставляет некоторые предопределенные имена полей слияния, которые можно вставлять в документ как MERGEFIELD или , используя поля ADDRESSBLOCK или GREETINGLINE. Информация, указанная вOdsoFieldMapData позволяет сопоставить один столбец во внешнем источнике данных с одним предопределенным полем слияния.

Примеры

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

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

// Эта коллекция определяет, как слияние почты будет сопоставлять столбцы из источника данных
// к предопределенным полям MERGEFIELD, ADDRESSBLOCK и GREETINGLINE.
OdsoFieldMapDataCollection dataCollection = doc.MailMergeSettings.Odso.FieldMapDatas;
Assert.AreEqual(30, dataCollection.Count);

using (IEnumerator<OdsoFieldMapData> enumerator = dataCollection.GetEnumerator())
{
    int index = 0;
    while (enumerator.MoveNext())
    {
        Console.WriteLine($"Field map data index {index++}, type \"{enumerator.Current.Type}\":");

        Console.WriteLine(
            enumerator.Current.Type != OdsoFieldMappingType.Null
                ? $"\tColumn \"{enumerator.Current.Name}\", number {enumerator.Current.Column} mapped to merge field \"{enumerator.Current.MappedName}\"."
                : "\tNo valid column to field mapping data present.");
    }
}

// Клонируем элементы этой коллекции.
Assert.AreNotEqual(dataCollection[0], dataCollection[0].Clone());

// Используйте элементы метода «RemoveAt» индивидуально по индексу.
dataCollection.RemoveAt(0);

Assert.AreEqual(29, dataCollection.Count);

// Используйте метод «Очистить», чтобы очистить всю коллекцию сразу.
dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

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

OdsoDataSourceType Enum OdsoFieldMapDataCollection Class