MailMergeSettings

MailMergeSettings class

Spécifie toutes les informations de publipostage pour un document.

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

public class MailMergeSettings

Constructeurs

Nom	La description
MailMergeSettings()	Default_Constructor

Propriétés

Nom	La description
ActiveRecord { get; set; }	Spécifie l’index de base un de l’enregistrement de la source de données qui doit être affiché dans Microsoft Word. La valeur par défaut est 1.
AddressFieldName { get; set; }	Spécifie la colonne de la source de données qui contient les adresses e-mail. La valeur par défaut est une chaîne vide.
CheckErrors { get; set; }	Spécifie le type de rapport d’erreurs qui doit être effectué par Microsoft Word lors de l’exécution d’un publipostage. La valeur par défaut estDefault .
ConnectString { get; set; }	Spécifie la chaîne de connexion utilisée pour se connecter à une source de données externe. La valeur par défaut est une chaîne vide.
DataSource { get; set; }	Spécifie le chemin d’accès à la source de données de publipostage. La valeur par défaut est une chaîne vide.
DataType { get; set; }	Spécifie le type de source de données de publipostage et la méthode d’accès aux données. La valeur par défaut estDefault .
Destination { get; set; }	Spécifie comment Microsoft Word affichera les résultats d’un publipostage. La valeur par défaut estDefault .
DoNotSupressBlankLines { get; set; }	Spécifie comment une application effectuant le publipostage doit gérer les lignes vides dans les documents fusionnés résultant du publipostage. La valeur par défaut est`FAUX` .
HeaderSource { get; set; }	Spécifie le chemin d’accès à la source de l’en-tête de publipostage. La valeur par défaut est une chaîne vide.
LinkToQuery { get; set; }	Je ne suis pas sûr de celui-ci. La référence d’automatisation de Microsoft Word suggère que cela spécifie que la requête est exécutée chaque fois que le document est ouvert dans Microsoft Word. Mais la spécification OOXML suggère que cela spécifie que la requête contient une référence à un fichier de requête externe qui contient la requête réelle. La valeur par défaut est`FAUX` .
MailAsAttachment { get; set; }	Spécifie que les documents produits lors d’une opération de fusion et publipostage doivent être envoyés par courrier électronique sous forme de pièce jointe plutôt que et non comme corps de l’e-mail lui-même. La valeur par défaut est`FAUX` .
MailSubject { get; set; }	Spécifie le texte qui doit apparaître dans la ligne d’objet des e-mails ou des fax produits lors du publipostage. La valeur par défaut est une chaîne vide.
MainDocumentType { get; set; }	Spécifie le type de document principal de publipostage. La valeur par défaut estDefault .
Odso { get; set; }	Obtient ou définit l’objet qui spécifie les paramètres de l’objet source de données Office (ODSO).
Query { get; set; }	Contient la chaîne du langage de requête structuré qui doit être exécutée sur la source de données externe spécifiée pour renvoyer l’ensemble d’enregistrements qui doivent être importés dans le document lorsque l’opération de fusion et publipostage est effectuée. La valeur par défaut est une chaîne vide.
ViewMergedData { get; set; }	Spécifie que Microsoft Word doit afficher les données de la source de données externe spécifiée dans laquelle les champs de fusion ont été insérés (par exemple, prévisualiser les données fusionnées). La valeur par défaut est`FAUX` .

Méthodes

Nom	La description
Clear()	Efface les paramètres de publipostage de telle manière que lorsque le document est enregistré, aucun paramètre de publipostage ne sera enregistré et il deviendra un document normal.
Clone()	Renvoie un clone profond de cet objet.

Remarques

Vous pouvez utiliser cet objet pour spécifier une source de données de publipostage pour un document et ces informations (ainsi que les champs de données disponibles) apparaîtront dans Microsoft Word lorsque l’utilisateur ouvrira ce document. Ou vous pouvez utiliser cet objet pour interroger les paramètres de fusion et de publipostage. que l’utilisateur a spécifié dans Microsoft Word pour ce document.

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

Pour détecter si ce document est un document principal de publipostage, vérifiez la valeur du MainDocumentType propriété.

Pour supprimer les paramètres de publipostage et les informations sur la source de données d’un document, vous pouvez utiliser le Clear méthode. Aspose.Words n’écrira pas les paramètres de publipostage dans un document si leMainDocumentType la propriété est définie surNotAMergeDocument ou leDataType la propriété est définie surNone.

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 duMailMergeSettings etOdso objets. C’est une bonne approche à adopter si vous souhaitez apprendre à configurer par programme une source de données, par exemple.

Aspose.Words conserve les informations de publipostage lors du chargement, de l’enregistrement et de la conversion de documents entre différents formats, mais n’utilise pas ces informations lors de l’exécution de son propre publipostage à l’aide de l’optionMailMerge objet.

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ée une source de données sous forme de fichier ASCII, avec le "|" personnage
// agissant comme délimiteur qui sépare les 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

espace de noms Aspose.Words.Settings
Assemblée Aspose.Words

MailMergeMainDocumentType Enum MsWordVersion Enum