Execute

Execute(IMailMergeDataSource)

Effectue un publipostage à partir d’une source de données personnalisée.

public void Execute(IMailMergeDataSource dataSource)

Paramètre	Taper	La description
dataSource	IMailMergeDataSource	Objet qui implémente l’interface de source de données de publipostage personnalisée.

Remarques

Utilisez cette méthode pour remplir les champs de publipostage du document avec les valeurs de n’importe quelle source de données telle qu’une liste, une table de hachage ou des objets. Vous devez écrire votre propre classe qui implémente leIMailMergeDataSource interface.

Vous pouvez utiliser cette méthode uniquement lorsqueIsBidiTextSupportedOnUpdate estFAUX, c’est-à-dire que vous n’avez pas besoin d’une compatibilité linguistique de droite à gauche (comme l’arabe ou l’hébreu).

Cette méthode ignore leRemoveUnusedRegions option.

Voir également

• interface IMailMergeDataSource
• class MailMerge
• espace de noms Aspose.Words.MailMerging
• Assemblée Aspose.Words

---

Execute(string[], object[])

Effectue une opération de publipostage pour un seul enregistrement.

public void Execute(string[] fieldNames, object[] values)

Paramètre	Taper	La description
fieldNames	String[]	Tableau de noms de champs de fusion. Les noms de champs ne sont pas sensibles à la casse. Si un nom de champ introuvable dans le document est rencontré, il est ignoré.
values	Object[]	Tableau de valeurs à insérer dans les champs de fusion. Le nombre d’éléments de ce tableau doit être le même que le nombre d’éléments defieldNames.

Remarques

Utilisez cette méthode pour remplir les champs de publipostage du document avec les valeurs from un tableau d’objets.

Cette méthode fusionne les données d’un seul enregistrement. Le tableau de noms de champs et le tableau de valeurs représentent les données d’un seul enregistrement.

Cette méthode n’utilise pas de régions de publipostage.

Cette méthode ignore leRemoveUnusedRegions option.

Exemples

Montre comment fusionner une image à partir d’un URI en tant que données de publipostage dans un MERGEFIELD.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Les MERGEFIELD avec les balises "Image:" recevront une image lors d'un publipostage.
// La chaîne après les deux points dans la balise "Image :" correspond à un nom de colonne
// dans la source de données dont les cellules contiennent les URI des fichiers image.
builder.InsertField("MERGEFIELD  Image:logo_FromWeb ");
builder.InsertField("MERGEFIELD  Image:logo_FromFileSystem ");

 // Créez une source de données contenant les URI des images que nous allons fusionner.
// Un URI peut être une URL Web qui pointe vers une image ou le nom de fichier du système de fichiers local d'un fichier image.
string[] columns = { "logo_FromWeb", "logo_FromFileSystem" };
object[] URIs = { ImageUrl, ImageDir + "Logo.jpg" };

// Exécute un publipostage sur une source de données avec une seule ligne.
doc.MailMerge.Execute(columns, URIs);

doc.Save(ArtifactsDir + "MailMergeEvent.ImageFromUrl.docx");

Montre comment effectuer un publipostage, puis enregistrer le document dans le navigateur client.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.InsertField(" MERGEFIELD FullName ");
builder.InsertParagraph();
builder.InsertField(" MERGEFIELD Company ");
builder.InsertParagraph();
builder.InsertField(" MERGEFIELD Address ");
builder.InsertParagraph();
builder.InsertField(" MERGEFIELD City ");

doc.MailMerge.Execute(new string[] { "FullName", "Company", "Address", "City" },
    new object[] { "James Bond", "MI5 Headquarters", "Milbank", "London" });

// Envoie le document au navigateur client.
Assert.That(() => doc.Save(response, "Artifacts/MailMerge.ExecuteArray.docx", ContentDisposition.Inline, null),
    Throws.TypeOf<ArgumentNullException>()); //Lancé car HttpResponse est nul dans le test.

// Nous devrons fermer cette réponse manuellement pour nous assurer de ne pas ajouter de contenu superflu au document après l'enregistrement.
Assert.That(() => response.End(), Throws.TypeOf<NullReferenceException>());

Voir également

• class MailMerge
• espace de noms Aspose.Words.MailMerging
• Assemblée Aspose.Words

---

Execute(DataTable)

Effectue le publipostage d’un DataTable dans le document.

public void Execute(DataTable table)

Paramètre	Taper	La description
table	DataTable	Table contenant les données à insérer dans les champs de publipostage. Les noms de champs ne sont pas sensibles à la casse. Si un nom de champ introuvable dans le document est rencontré, il est ignoré.

Remarques

Utilisez cette méthode pour remplir les champs de publipostage du document avec les valeurs de a Table de données.

Tous les enregistrements de la table sont fusionnés dans le document.

Vous pouvez utiliser le champ NEXT dans le document Word pour provoquerMailMerge objet pour sélectionner enregistrement suivant duTable de données et continuez la fusion. Ceci peut être utilisé lors de la création de documents tels que des étiquettes de publipostage.

QuandMailMerge l’objet atteint la fin du document principal et il reste encore des lignes more dans leTable de données, il copie l’intégralité du contenu de le document principal et l’ajoute à la fin du document de destination en utilisant un saut section comme séparateur.

Cette méthode ignore leRemoveUnusedRegions option.

Exemples

Montre comment exécuter un publipostage avec les données d’un DataTable.

public void ExecuteDataTable()
{
    DataTable table = new DataTable("Test");
    table.Columns.Add("CustomerName");
    table.Columns.Add("Address");
    table.Rows.Add(new object[] { "Thomas Hardy", "120 Hanover Sq., London" });
    table.Rows.Add(new object[] { "Paolo Accorti", "Via Monte Bianco 34, Torino" });

    // Vous trouverez ci-dessous deux manières d'utiliser un DataTable comme source de données pour un publipostage.
    // 1 - Utilisez le tableau entier pour le publipostage afin de créer un document de publipostage de sortie pour chaque ligne du tableau :
    Document doc = CreateSourceDocExecuteDataTable();

    doc.MailMerge.Execute(table);

    doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.WholeTable.docx");

    // 2 - Utilisez une ligne du tableau pour créer un document de publipostage en sortie :
    doc = CreateSourceDocExecuteDataTable();

    doc.MailMerge.Execute(table.Rows[1]);

    doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.OneRow.docx");
}

/// <summary>
/// Crée un document source de publipostage.
/// </summary>
private static Document CreateSourceDocExecuteDataTable()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    builder.InsertField(" MERGEFIELD CustomerName ");
    builder.InsertParagraph();
    builder.InsertField(" MERGEFIELD Address ");

    return doc;
}

Voir également

• class MailMerge
• espace de noms Aspose.Words.MailMerging
• Assemblée Aspose.Words

---

Execute(IDataReader)

Effectue un publipostage à partir deIDataReader dans le document.

public void Execute(IDataReader dataReader)

Paramètre	Taper	La description
dataReader	IDataReader	Source de données pour l’opération de publipostage.

Remarques

Tu peux passerSQLDataReader ouOleDbDataReader objet dans la méthode this en tant que paramètre car ils ont tous deux implémentéIDataReader interface.

Notez que cette méthode n’utilise pas de régions de fusion et de publipostage et pour plusieurs enregistrements, le document s’agrandira en répétant l’intégralité du document.

Cette méthode ignore leRemoveUnusedRegions option.

Exemples

Montre comment exécuter un publipostage à l’aide des données d’un lecteur de données.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Product:\t");
builder.InsertField(" MERGEFIELD ProductName");
builder.Write("\nSupplier:\t");
builder.InsertField(" MERGEFIELD CompanyName");
builder.Writeln();
builder.InsertField(" MERGEFIELD QuantityPerUnit");
builder.Write(" for $");
builder.InsertField(" MERGEFIELD UnitPrice");

// Crée une chaîne de connexion qui pointe vers le fichier de base de données "Northwind"
// dans notre système de fichiers local, ouvrez une connexion et configurez une requête SQL.
string connectionString = @"Provider = Microsoft.ACE.OLEDB.12.0; Data Source=" + DatabaseDir + "Northwind.accdb";
string query =
    @"SELECT Products.ProductName, Suppliers.CompanyName, Products.QuantityPerUnit, Products.UnitPrice
    FROM Products 
    INNER JOIN Suppliers 
    ON Products.SupplierID = Suppliers.SupplierID";

using (OleDbConnection connection = new OleDbConnection(connectionString))
{
    // Créez une commande SQL qui générera des données pour notre publipostage.
    // Les noms des colonnes de la table que cette instruction SELECT renverra
    // devra correspondre aux champs de fusion que nous avons placés ci-dessus.
    OleDbCommand command = new OleDbCommand(query, connection);
    command.CommandText = query;
    try
    {                    
        connection.Open();                 
        using (OleDbDataReader reader = command.ExecuteReader())
        {
            // Récupère les données du lecteur et les utilise dans le publipostage.
            doc.MailMerge.Execute(reader);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine(ex.Message);
    }                
}

doc.Save(ArtifactsDir + "MailMerge.ExecuteDataReader.docx");

Voir également

• class MailMerge
• espace de noms Aspose.Words.MailMerging
• Assemblée Aspose.Words

---

Execute(DataView)

Effectue un publipostage à partir d’unVue de données dans le document.

public void Execute(DataView dataView)

Paramètre	Taper	La description
dataView	DataView	Source de données pour l’opération de publipostage.

Remarques

Cette méthode est utile si vous récupérez des données dans unTable de données mais then doit appliquer un filtre ou un tri avant le publipostage.

Notez que cette méthode n’utilise pas de régions de fusion et de publipostage et pour plusieurs enregistrements, le document s’agrandira en répétant l’intégralité du document.

Cette méthode ignore leRemoveUnusedRegions option.

Exemples

Montre comment modifier les données de publipostage avec un DataView.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Write("Congratulations ");
builder.InsertField(" MERGEFIELD Name");
builder.Write(" for passing with a grade of ");
builder.InsertField(" MERGEFIELD Grade");

// Créez une table de données à partir de laquelle notre publipostage extraira les données.
DataTable table = new DataTable("ExamResults");
table.Columns.Add("Name");
table.Columns.Add("Grade");
table.Rows.Add(new object[] { "John Doe", "67" });
table.Rows.Add(new object[] { "Jane Doe", "81" });
table.Rows.Add(new object[] { "John Cardholder", "47" });
table.Rows.Add(new object[] { "Joe Bloggs", "75" });

// Nous pouvons utiliser une vue de données pour modifier les données de publipostage sans apporter de modifications à la table de données elle-même.
DataView view = new DataView(table);
view.Sort = "Grade DESC";
view.RowFilter = "Grade >= 50";

// Notre vue de données trie les entrées par ordre décroissant le long de la colonne "Note"
// et filtre les lignes avec des valeurs inférieures à 50 sur cette colonne.
// Trois des quatre lignes correspondent à ces critères, de sorte que le document de sortie contiendra trois documents de fusion.
doc.MailMerge.Execute(view);

doc.Save(ArtifactsDir + "MailMerge.ExecuteDataView.docx");

Voir également

• class MailMerge
• espace de noms Aspose.Words.MailMerging
• Assemblée Aspose.Words

---

Execute(DataRow)

Effectue un publipostage à partir d’unLigne de données dans le document.

public void Execute(DataRow row)

Paramètre	Taper	La description
row	DataRow	Ligne contenant des données à insérer dans les champs de publipostage. Les noms de champs ne sont pas sensibles à la casse. Si un nom de champ introuvable dans le document est rencontré, il est ignoré.

Remarques

Utilisez cette méthode pour remplir les champs de publipostage du document avec les valeurs d’unLigne de données.

Cette méthode ignore leRemoveUnusedRegions option.

Exemples

Montre comment exécuter un publipostage avec les données d’un DataTable.

public void ExecuteDataTable()
{
    DataTable table = new DataTable("Test");
    table.Columns.Add("CustomerName");
    table.Columns.Add("Address");
    table.Rows.Add(new object[] { "Thomas Hardy", "120 Hanover Sq., London" });
    table.Rows.Add(new object[] { "Paolo Accorti", "Via Monte Bianco 34, Torino" });

    // Vous trouverez ci-dessous deux manières d'utiliser un DataTable comme source de données pour un publipostage.
    // 1 - Utilisez le tableau entier pour le publipostage afin de créer un document de publipostage de sortie pour chaque ligne du tableau :
    Document doc = CreateSourceDocExecuteDataTable();

    doc.MailMerge.Execute(table);

    doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.WholeTable.docx");

    // 2 - Utilisez une ligne du tableau pour créer un document de publipostage en sortie :
    doc = CreateSourceDocExecuteDataTable();

    doc.MailMerge.Execute(table.Rows[1]);

    doc.Save(ArtifactsDir + "MailMerge.ExecuteDataTable.OneRow.docx");
}

/// <summary>
/// Crée un document source de publipostage.
/// </summary>
private static Document CreateSourceDocExecuteDataTable()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    builder.InsertField(" MERGEFIELD CustomerName ");
    builder.InsertParagraph();
    builder.InsertField(" MERGEFIELD Address ");

    return doc;
}

Voir également

• class MailMerge
• espace de noms Aspose.Words.MailMerging
• Assemblée Aspose.Words