Odso

Odso class

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

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

public class Odso

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

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

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

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

Методы

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

Примечания

ODSO, по-видимому, является «новым» способом, который предпочитают использовать новые версии Microsoft Word при указании определенных типов источников данных для документа слияния почты. ОДСО, вероятно, впервые появился в 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");

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