Odso

Odso class

Spécifie les paramètres de l’objet source de données Office (ODSO) pour une source de données de publipostage.

Pour en savoir plus, visitez leFusion et publipostage et création de rapports article de documentation.

public class Odso

Constructeurs

NomLa description
Odso()Default_Constructor

Propriétés

NomLa description
ColumnDelimiter { get; set; }Spécifie le caractère qui doit être interprété comme le délimiteur de colonne utilisé pour séparer les colonnes dans les sources de données externes. La valeur par défaut est 0, ce qui signifie qu’aucun délimiteur de colonne n’est défini.
DataSource { get; set; }Spécifie l’emplacement de la source de données externe à connecter à un document pour effectuer le publipostage. La valeur par défaut est une chaîne vide.
DataSourceType { get; set; }Spécifie le type de source de données externe à laquelle se connecter dans le cadre des informations de connexion ODSO pour ce publipostage. La valeur par défaut estDefault .
FieldMapDatas { get; set; }Obtient ou définit une collection d’objets qui spécifient comment les colonnes de la source de données externe sont mappées aux noms de champs de fusion prédéfinis dans le document. Cet objet n’est jamaisnul .
FirstRowContainsColumnNames { get; set; }Spécifie qu’une application d’hébergement doit traiter la première ligne de données dans la source de données externe spécifiée comme une ligne d’en-tête contenant les noms de chaque colonne de la source de données. La valeur par défaut estFAUX .
RecipientDatas { get; set; }Obtient ou définit une collection d’objets qui spécifient l’inclusion/l’exclusion d’enregistrements individuels dans le publipostage. Cet objet n’est jamaisnul .
TableName { get; set; }Spécifie l’ensemble particulier de données auquel une source doit être connectée dans une source de données externe. La valeur par défaut est une chaîne vide.
UdlConnectString { get; set; }Spécifie la chaîne de connexion Universal Data Link (UDL) utilisée pour se connecter à une source de données externe. La valeur par défaut est une chaîne vide.

Méthodes

NomLa description
Clone()Renvoie un clone profond de cet objet.

Remarques

ODSO semble être la nouvelle méthode privilégiée par les nouvelles versions de Microsoft Word pour spécifier certains types de sources de données pour un document de publipostage. ODSO est probablement apparu pour la première fois dans Microsoft Word 2000.

L’utilisation d’ODSO est mal documentée et la meilleure façon d’apprendre à utiliser les propriétés de cet objet est de créer manuellement un document avec une source de données souhaitée dans Microsoft Word, puis d’ouvrir ce document à l’aide d’Aspose.Words et d’examiner les propriétés de l’objet.MailMergeSettings et Odsoobjets. C’est une bonne approche à adopter si vous souhaitez apprendre à configurer une source de données par programmation, par exemple.

Vous n’avez normalement pas besoin de créer directement des objets de cette classe car les paramètres ODSO sont toujours disponibles via leOdso propriété.

Exemples

Montre comment exécuter un publipostage avec des données provenant d’un objet source de données 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>");

// Créer une source de données sous la forme d'un fichier ASCII, avec le caractère "|"
// agit comme séparateur de colonnes. La première ligne contient les noms des trois colonnes.
// et chaque ligne suivante est une ligne avec leurs valeurs respectives.
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());

 // L'ouverture de ce document dans Microsoft Word exécutera le publipostage avant d'afficher le contenu.
doc.Save(ArtifactsDir + "MailMerge.MailMergeSettings.docx");

Voir également

MultiplePagesType Enum OdsoDataSourceType Enum