Odso

Odso class

Указывает параметры объекта источника данных Office (ODSO) для источника данных слияния.

public class Odso

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

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

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

Имя Описание
ColumnDelimiter { get; set; } Указывает символ, который должен интерпретироваться как разделитель столбцов, используемый для разделения столбцов во внешних источниках данных. Значение по умолчанию — 0, что означает, что разделитель столбцов не определен.
DataSource { get; set; } Указывает расположение внешнего источника данных, который необходимо подключить к документу для выполнения слияния почты. Значение по умолчанию — пустая строка.
DataSourceType { get; set; } Указывает тип внешнего источника данных, к которому необходимо подключиться, как часть информации о подключении ODSO для этого слияния. Значение по умолчанию:Default .
FieldMapDatas { get; set; } Получает или задает набор объектов, указывающих, как столбцы из внешнего источника данных сопоставляются с предопределенными именами полей слияния в документе. Этот объект никогда не имеет значение null.
FirstRowContainsColumnNames { get; set; } Указывает, что хост-приложение должно обрабатывать первую строку данных в указанном внешнем источнике data как строку заголовка, содержащую имена каждого столбца в источнике данных. Значение по умолчанию:ЛОЖЬ .
RecipientDatas { get; set; } Получает или задает набор объектов, определяющих включение/исключение отдельных записей при слиянии почты. Этот объект никогда не имеет значение null.
TableName { get; set; } Указывает конкретный набор данных, к которому должен быть подключен источник во внешнем источнике данных. Значение по умолчанию — пустая строка.
UdlConnectString { get; set; } Задает строку подключения к универсальному каналу передачи данных (UDL), используемую для подключения к внешнему источнику данных. Значение по умолчанию — пустая строка.

Методы

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

Примечания

ODSO кажется «новым» способом, который предпочитают использовать более новые версии Microsoft Word при указании определенных типов источников данных для документа слияния. ODSO, вероятно, впервые появился в Microsoft Word 2000.

Использование ODSO плохо документировано, и лучший способ узнать, как использовать свойства этого объекта , — создать документ с нужным источником данных вручную в Microsoft Word, а затем открыть этот документ с помощью Aspose.Words и изучить свойства. принадлежащийMailMergeSettings и Odso объекты. Это хороший подход, если вы хотите узнать, как программно настроить источник данных, например.

Обычно вам не нужно создавать объекты этого класса напрямую, потому что настройки ODSO всегда доступны черезOdso имущество.

Примеры

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

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Dear ");
builder.InsertField("MERGEFIELD FirstName", "<FirstName>");
builder.Write(" ");
builder.InsertField("MERGEFIELD LastName", "<LastName>");
builder.Writeln(": ");
builder.InsertField("MERGEFIELD Message", "<Message>");

// Создаем источник данных в виде ASCII-файла с символом "|" персонаж
// действует как разделитель, разделяющий столбцы. Первая строка содержит имена трех столбцов,
// и каждая последующая строка представляет собой строку с соответствующими значениями.
string[] lines = { "FirstName|LastName|Message",
    "John|Doe|Hello! This message was created with Aspose Words mail merge." };
string dataSrcFilename = ArtifactsDir + "MailMerge.MailMergeSettings.DataSource.txt";

File.WriteAllLines(dataSrcFilename, lines);

MailMergeSettings settings = doc.MailMergeSettings;
settings.MainDocumentType = MailMergeMainDocumentType.MailingLabels;
settings.CheckErrors = MailMergeCheckErrors.Simulate;
settings.DataType = MailMergeDataType.Native;
settings.DataSource = dataSrcFilename;
settings.Query = "SELECT * FROM " + doc.MailMergeSettings.DataSource;
settings.LinkToQuery = true;
settings.ViewMergedData = true;

Assert.AreEqual(MailMergeDestination.Default, settings.Destination);
Assert.False(settings.DoNotSupressBlankLines);

Odso odso = settings.Odso;
odso.DataSource = dataSrcFilename;
odso.DataSourceType = OdsoDataSourceType.Text;
odso.ColumnDelimiter = '|';
odso.FirstRowContainsColumnNames = true;

Assert.AreNotSame(odso, odso.Clone());
Assert.AreNotSame(settings, settings.Clone());

// Открытие этого документа в Microsoft Word приведет к выполнению слияния перед отображением содержимого. 
doc.Save(ArtifactsDir + "MailMerge.MailMergeSettings.docx");

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