Odso

Odso class

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

Um mehr zu erfahren, besuchen Sie dieSerienbriefe und Berichte Dokumentationsartikel.

public class Odso

Konstrukteure

NameBeschreibung
Odso()Default_Constructor

Eigenschaften

NameBeschreibung
ColumnDelimiter { get; set; }Gibt das Zeichen an, das als Spaltentrennzeichen interpretiert werden soll, 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 Serienbriefvorgang durchzuführen. Der Standardwert ist eine leere Zeichenfolge.
DataSourceType { get; set; }Gibt den Typ der externen Datenquelle an, mit der als Teil der ODSO-Verbindungsinformationen für diesen Serienbrief eine Verbindung hergestellt werden soll. 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 Seriendruckfeldnamen im Dokument zugeordnet werden. Dieses Objekt wird nienull .
FirstRowContainsColumnNames { get; set; }Gibt an, dass eine Hostanwendung die erste Datenzeile in der angegebenen externen Datenquelle als Kopfzeile behandeln soll, die die Namen aller Spalten in der Datenquelle enthält. Der Standardwert istFALSCH .
RecipientDatas { get; set; }Ruft eine Sammlung von Objekten ab oder legt sie fest, die die Einbeziehung/den Ausschluss einzelner Datensätze in den Serienbrief festlegen. Dieses Objekt ist nienull .
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 zum Herstellen einer Verbindung mit einer externen Datenquelle verwendet wird. Der Standardwert ist eine leere Zeichenfolge.

Methoden

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

Bemerkungen

ODSO scheint die neue Methode zu sein, die neuere Microsoft Word-Versionen bevorzugen, um bestimmte -Datenquellentypen für ein Seriendruckdokument anzugeben. ODSO tauchte wahrscheinlich erstmals in Microsoft Word 2000 auf.

Die Verwendung von ODSO ist schlecht dokumentiert und der beste Weg, die Eigenschaften dieses Objekts zu erlernen, 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 desMailMergeSettings und OdsoObjekte. 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 erstellen, da ODSO-Einstellungen immer über dieOdso Eigentum.

Beispiele

Zeigt, wie ein Serienbrief 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 Zeichen "|"
// dient als Trennzeichen zwischen den Spalten. Die erste Zeile enthält die Namen der drei Spalten,
// und jede nachfolgende Zeile ist eine Reihe mit den 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());

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

Siehe auch

MultiplePagesType Enum OdsoDataSourceType Enum