Odso

Odso class

Gibt die Office Data Source Object (ODSO)-Einstellungen für eine Seriendruck-Datenquelle an.

public class Odso

Konstrukteure

Name Beschreibung
Odso() Default_Constructor

Eigenschaften

Name Beschreibung
ColumnDelimiter { get; set; } Gibt das Zeichen an, das als Spaltentrennzeichen interpretiert werden soll, das verwendet wird, um Spalten innerhalb externer Datenquellen zu trennen. Der Standardwert ist 0, was bedeutet, dass kein Spaltentrennzeichen definiert ist.
DataSource { get; set; } Gibt den Speicherort der externen Datenquelle an, die mit einem Dokument verbunden werden soll, um den Seriendruck durchzuführen. Der Standardwert ist eine leere Zeichenfolge.
DataSourceType { get; set; } Gibt den Typ der externen Datenquelle an, mit der eine Verbindung hergestellt werden soll, als Teil der ODSO-Verbindungsinformationen für diesen Seriendruck. Der Standardwert istDefault .
FieldMapDatas { get; set; } Ruft eine Sammlung von Objekten ab oder legt diese fest, die angeben, wie Spalten aus der externen Datenquelle den vordefinierten Briefvorlagenfeldnamen im Dokument zugeordnet werden. Dieses Objekt ist niemals null.
FirstRowContainsColumnNames { get; set; } Gibt an, dass eine Hostanwendung die erste Datenzeile in der angegebenen externen Datenquelle als Kopfzeile behandeln soll, die die Namen jeder Spalte in der Datenquelle enthält. Der Standardwert istFALSCH .
RecipientDatas { get; set; } Ruft eine Sammlung von Objekten ab oder legt diese fest, die den Einschluss/Ausschluss einzelner Datensätze in den Seriendruck festlegen. Dieses Objekt ist niemals null.
TableName { get; set; } Gibt den bestimmten Datensatz an, mit dem eine Quelle innerhalb einer externen Datenquelle verbunden werden soll. Der Standardwert ist eine leere Zeichenfolge.
UdlConnectString { get; set; } Gibt die Universal Data Link (UDL)-Verbindungszeichenfolge an, die verwendet wird, um eine Verbindung zu einer externen Datenquelle herzustellen. Der Standardwert ist eine leere Zeichenfolge.

Methoden

Name Beschreibung
Clone() Gibt einen tiefen Klon dieses Objekts zurück.

Bemerkungen

ODSO scheint der “neue” Weg zu sein, den die neueren Microsoft Word-Versionen bevorzugt verwenden, wenn sie bestimmte -Typen von Datenquellen für ein Serienbriefdokument angeben. ODSO erschien wahrscheinlich zuerst in Microsoft Word 2000.

Die Verwendung von ODSO ist schlecht dokumentiert und der beste Weg, um zu lernen, wie man die Eigenschaften dieses Objekts verwendet, besteht darin, ein Dokument mit einer gewünschten Datenquelle manuell in Microsoft Word zu erstellen und dieses Dokument dann mit Aspose.Words zu öffnen und die Eigenschaften zu untersuchen desMailMergeSettings und Odso Objekte. Dies ist ein guter Ansatz, wenn Sie beispielsweise lernen möchten, wie Sie eine Datenquelle programmgesteuert konfigurieren.

Normalerweise müssen Sie Objekte dieser Klasse nicht direkt anlegen, da ODSO settings immer über die verfügbar sindOdso Eigentum.

Beispiele

Zeigt, wie ein Seriendruck mit Daten aus einem Office-Datenquellenobjekt ausgeführt wird.

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

// Erstellen Sie eine Datenquelle in Form einer ASCII-Datei, mit dem "|" Charakter
// fungiert als Trennzeichen, das Spalten trennt. Die erste Zeile enthält die Namen der drei Spalten,
// und jede nachfolgende Zeile ist eine Zeile mit ihren jeweiligen Werten.
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());

// Beim Öffnen dieses Dokuments in Microsoft Word wird der Seriendruck ausgeführt, bevor der Inhalt angezeigt wird. 
doc.Save(ArtifactsDir + "MailMerge.MailMergeSettings.docx");

Siehe auch