ExecuteWithRegions

ExecuteWithRegions(IMailMergeDataSource)

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

public void ExecuteWithRegions(IMailMergeDataSource dataSource)

Paramètre	Taper	La description
dataSource	IMailMergeDataSource	Un 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 des valeurs provenant de n’importe quelle source de données personnalisée, telle qu’un fichier XML ou une collection d’objets métier. Vous devez écrire votre propre classe implémentant cette méthode.IMailMergeDataSource interface.

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

Exemples

Montre comment utiliser les régions de publipostage pour exécuter un publipostage imbriqué.

public void CustomDataSource()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    // Normalement, les MERGEFIELD contiennent le nom d'une colonne d'une source de données de publipostage.
    // Au lieu de cela, nous pouvons utiliser les préfixes « TableStart : » et « TableEnd : » pour commencer/terminer une région de publipostage.
    // Chaque région appartiendra à une table avec un nom qui correspond à la chaîne immédiatement après les deux points du préfixe.
    builder.InsertField(" MERGEFIELD TableStart:Customers");

    // Ces MERGEFIELD se trouvent à l'intérieur de la zone de fusion et de publipostage de la table « Clients ».
    // Lorsque nous exécutons le publipostage, ce champ recevra des données provenant de lignes d'une source de données nommée « Clients ».
    builder.Write("Full name:\t");
    builder.InsertField(" MERGEFIELD FullName ");
    builder.Write("\nAddress:\t");
    builder.InsertField(" MERGEFIELD Address ");
    builder.Write("\nOrders:\n");

    // Créez une deuxième région de publipostage à l'intérieur de la région externe pour une source de données nommée « Commandes ».
    // Les entrées de données « Commandes » ont une relation plusieurs-à-un avec la source de données « Clients ».
    builder.InsertField(" MERGEFIELD TableStart:Orders");

    builder.Write("\tItem name:\t");
    builder.InsertField(" MERGEFIELD Name ");
    builder.Write("\n\tQuantity:\t");
    builder.InsertField(" MERGEFIELD Quantity ");
    builder.InsertParagraph();

    builder.InsertField(" MERGEFIELD TableEnd:Orders");
    builder.InsertField(" MERGEFIELD TableEnd:Customers");

    // Créez des données associées avec des noms qui correspondent à ceux de nos régions de publipostage.
    CustomerList customers = new CustomerList();
    customers.Add(new Customer("Thomas Hardy", "120 Hanover Sq., London"));
    customers.Add(new Customer("Paolo Accorti", "Via Monte Bianco 34, Torino"));

    customers[0].Orders.Add(new Order("Rugby World Cup Cap", 2));
    customers[0].Orders.Add(new Order("Rugby World Cup Ball", 1));
    customers[1].Orders.Add(new Order("Rugby World Cup Guide", 1));

    // Pour effectuer un publipostage à partir de votre source de données, nous devons l'encapsuler dans un objet qui implémente l'interface IMailMergeDataSource.
    CustomerMailMergeDataSource customersDataSource = new CustomerMailMergeDataSource(customers);

    doc.MailMerge.ExecuteWithRegions(customersDataSource);

    doc.Save(ArtifactsDir + "NestedMailMergeCustom.CustomDataSource.docx");
}

/// <summary>
/// Un exemple de classe « entité de données » dans votre application.
/// </summary>
public class Customer
{
    public Customer(string aFullName, string anAddress)
    {
        FullName = aFullName;
        Address = anAddress;
        Orders = new List<Order>();
    }

    public string FullName { get; set; }
    public string Address { get; set; }
    public List<Order> Orders { get; set; }
}

/// <summary>
/// Un exemple de collection typée qui contient vos objets « données ».
/// </summary>
public class CustomerList : ArrayList
{
    public new Customer this[int index]
    {
        get { return (Customer) base[index]; }
        set { base[index] = value; }
    }
}

/// <summary>
/// Un exemple d'une classe « entité de données » enfant dans votre application.
/// </summary>
public class Order
{
    public Order(string oName, int oQuantity)
    {
        Name = oName;
        Quantity = oQuantity;
    }

    public string Name { get; set; }
    public int Quantity { get; set; }
}

/// <summary>
 /// Une source de données de publipostage personnalisée que vous implémentez pour autoriser Aspose.Words
/// pour fusionner les données de vos objets Client dans des documents Microsoft Word.
/// </summary>
public class CustomerMailMergeDataSource : IMailMergeDataSource
{
    public CustomerMailMergeDataSource(CustomerList customers)
    {
        mCustomers = customers;

        // Lorsque nous initialisons la source de données, sa position doit être avant le premier enregistrement.
        mRecordIndex = -1;
    }

    /// <summary>
    /// Nom de la source de données. Utilisé par Aspose.Words uniquement lors d'un publipostage avec des régions répétables.
    /// </summary>
    public string TableName
    {
        get { return "Customers"; }
    }

    /// <summary>
    /// Aspose.Words appelle cette méthode pour obtenir une valeur pour chaque champ de données.
    /// </summary>
    public bool GetValue(string fieldName, out object fieldValue)
    {
        switch (fieldName)
        {
            case "FullName":
                fieldValue = mCustomers[mRecordIndex].FullName;
                return true;
            case "Address":
                fieldValue = mCustomers[mRecordIndex].Address;
                return true;
            case "Order":
                fieldValue = mCustomers[mRecordIndex].Orders;
                return true;
            default:
                // Renvoyer « false » au moteur de publipostage Aspose.Words pour signifier
                // que nous n'avons pas pu trouver de champ avec ce nom.
                fieldValue = null;
                return false;
        }
    }

    /// <summary>
    /// Une implémentation standard pour passer à l'enregistrement suivant dans une collection.
    /// </summary>
    public bool MoveNext()
    {
        if (!IsEof)
            mRecordIndex++;

        return !IsEof;
    }

    public IMailMergeDataSource GetChildDataSource(string tableName)
    {
        switch (tableName)
        {
            // Obtenez la source de données enfant, dont le nom correspond à la région de publipostage qui utilise ses colonnes.
            case "Orders":
                return new OrderMailMergeDataSource(mCustomers[mRecordIndex].Orders);
            default:
                return null;
        }
    }

    private bool IsEof
    {
        get { return (mRecordIndex >= mCustomers.Count); }
    }

    private readonly CustomerList mCustomers;
    private int mRecordIndex;
}

public class OrderMailMergeDataSource : IMailMergeDataSource
{
    public OrderMailMergeDataSource(List<Order> orders)
    {
        mOrders = orders;

        // Lorsque nous initialisons la source de données, sa position doit être avant le premier enregistrement.
        mRecordIndex = -1;
    }

    /// <summary>
    /// Nom de la source de données. Utilisé par Aspose.Words uniquement lors d'un publipostage avec des régions répétables.
    /// </summary>
    public string TableName
    {
        get { return "Orders"; }
    }

    /// <summary>
    /// Aspose.Words appelle cette méthode pour obtenir une valeur pour chaque champ de données.
    /// </summary>
    public bool GetValue(string fieldName, out object fieldValue)
    {
        switch (fieldName)
        {
            case "Name":
                fieldValue = mOrders[mRecordIndex].Name;
                return true;
            case "Quantity":
                fieldValue = mOrders[mRecordIndex].Quantity;
                return true;
            default:
                // Renvoyer « false » au moteur de publipostage Aspose.Words pour signifier
                // que nous n'avons pas pu trouver de champ avec ce nom.
                fieldValue = null;
                return false;
        }
    }

    /// <summary>
    /// Une implémentation standard pour passer à l'enregistrement suivant dans une collection.
    /// </summary>
    public bool MoveNext()
    {
        if (!IsEof)
            mRecordIndex++;

        return !IsEof;
    }

    /// <summary>
    /// Renvoie null car nous n'avons aucun élément enfant pour ce type d'objet.
    /// </summary>
    public IMailMergeDataSource GetChildDataSource(string tableName)
    {
        return null;
    }

    private bool IsEof
    {
        get { return (mRecordIndex >= mOrders.Count); }
    }

    private readonly List<Order> mOrders;
    private int mRecordIndex;
}

Voir également

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

---

ExecuteWithRegions(IMailMergeDataSourceRoot)

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

public void ExecuteWithRegions(IMailMergeDataSourceRoot dataSourceRoot)

Paramètre	Taper	La description
dataSourceRoot	IMailMergeDataSourceRoot	Un objet qui implémente l’interface racine de la source de données de publipostage personnalisée.

Remarques

Utilisez cette méthode pour remplir les champs de publipostage du document avec des valeurs provenant de n’importe quelle source de données personnalisée, telle qu’un fichier XML ou des collections d’objets métier. Vous devez écrire vos propres classes implémentant la méthode.IMailMergeDataSourceRoot etIMailMergeDataSource interfaces.

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

Exemples

Effectue un publipostage à partir d’une source de données personnalisée avec des données maître-détails.

public void CustomDataSourceRoot()
{
    // Créez un document avec deux régions de publipostage nommées « Washington » et « Seattle ».
    string[] mailMergeRegions = { "Vancouver", "Seattle" };
    Document doc = CreateSourceDocumentWithMailMergeRegions(mailMergeRegions);

    // Créez deux sources de données pour le publipostage.
    EmployeeList employeesWashingtonBranch = new EmployeeList();
    employeesWashingtonBranch.Add(new Employee("John Doe", "Sales"));
    employeesWashingtonBranch.Add(new Employee("Jane Doe", "Management"));

    EmployeeList employeesSeattleBranch = new EmployeeList();
    employeesSeattleBranch.Add(new Employee("John Cardholder", "Management"));
    employeesSeattleBranch.Add(new Employee("Joe Bloggs", "Sales"));

    // Enregistrez nos sources de données par nom dans une racine de source de données.
    // Si nous sommes sur le point d'utiliser cette racine de source de données dans un publipostage avec des régions,
    // le nom enregistré de chaque source doit correspondre au nom d'une région de publipostage existante dans le document source de publipostage.
    DataSourceRoot sourceRoot = new DataSourceRoot();
    sourceRoot.RegisterSource(mailMergeRegions[0], new EmployeeListMailMergeSource(employeesWashingtonBranch));
    sourceRoot.RegisterSource(mailMergeRegions[1], new EmployeeListMailMergeSource(employeesSeattleBranch));

    // Étant donné que nous avons des régions de publipostage consécutives, nous devrions normalement effectuer deux publipostages.
    // Cependant, une source de publipostage avec une racine de données peut remplir plusieurs régions
    // si la racine contient des tables avec des noms/noms de colonnes correspondants.
    doc.MailMerge.ExecuteWithRegions(sourceRoot);

    doc.Save(ArtifactsDir + "MailMergeCustom.CustomDataSourceRoot.docx");
}

/// <summary>
/// Créez un document contenant des régions de publipostage consécutives, avec des noms désignés par le tableau d'entrée,
/// pour un tableau de données des employés.
/// </summary>
private static Document CreateSourceDocumentWithMailMergeRegions(string[] regions)
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    foreach (string s in regions)
    {
        builder.Writeln("\n" + s + " branch: ");
        builder.InsertField(" MERGEFIELD TableStart:" + s);
        builder.InsertField(" MERGEFIELD FullName");
        builder.Write(", ");
        builder.InsertField(" MERGEFIELD Department");
        builder.InsertField(" MERGEFIELD TableEnd:" + s);
    }

    return doc;
}

/// <summary>
/// Un exemple de classe « entité de données » dans votre application.
/// </summary>
private class Employee
{
    public Employee(string aFullName, string aDepartment)
    {
        FullName = aFullName;
        Department = aDepartment;
    }

    public string FullName { get; }
    public string Department { get; }
}

/// <summary>
/// Un exemple de collection typée qui contient vos objets « données ».
/// </summary>
private class EmployeeList : ArrayList
{
    public new Employee this[int index]
    {
        get { return (Employee)base[index]; }
        set { base[index] = value; }
    }
}

/// <summary>
/// Racine de la source de données qui peut être transmise directement dans un publipostage qui peut enregistrer et contenir de nombreuses sources de données enfants.
/// Ces sources doivent toutes implémenter IMailMergeDataSource, et sont enregistrées et différenciées par un nom
/// qui correspond à une région de publipostage qui lira les données respectives.
/// </summary>
private class DataSourceRoot : IMailMergeDataSourceRoot
{
    public IMailMergeDataSource GetDataSource(string tableName)
    {
        EmployeeListMailMergeSource source = mSources[tableName];
        source.Reset();
        return mSources[tableName];
    }

    public void RegisterSource(string sourceName, EmployeeListMailMergeSource source)
    {
        mSources.Add(sourceName, source);
    }

    private readonly Dictionary<string, EmployeeListMailMergeSource> mSources = new Dictionary<string, EmployeeListMailMergeSource>();
}

/// <summary>
/// Source de données de publipostage personnalisée.
/// </summary>
private class EmployeeListMailMergeSource : IMailMergeDataSource
{
    public EmployeeListMailMergeSource(EmployeeList employees)
    {
        mEmployees = employees;
        mRecordIndex = -1;
    }

    /// <summary>
    /// Une implémentation standard pour passer à l'enregistrement suivant dans une collection.
    /// </summary>
    public bool MoveNext()
    {
        if (!IsEof)
            mRecordIndex++;

        return !IsEof;
    }

    private bool IsEof
    {
        get { return (mRecordIndex >= mEmployees.Count); }
    }

    public void Reset()
    {
        mRecordIndex = -1;
    }

    /// <summary>
    /// Nom de la source de données. Utilisé par Aspose.Words uniquement lors d'un publipostage avec des régions répétables.
    /// </summary>
    public string TableName
    {
        get { return "Employees"; }
    }

    /// <summary>
    /// Aspose.Words appelle cette méthode pour obtenir une valeur pour chaque champ de données.
    /// </summary>
    public bool GetValue(string fieldName, out object fieldValue)
    {
        switch (fieldName)
        {
            case "FullName":
                fieldValue = mEmployees[mRecordIndex].FullName;
                return true;
            case "Department":
                fieldValue = mEmployees[mRecordIndex].Department;
                return true;
            default:
                // Renvoyer « false » au moteur de publipostage Aspose.Words pour signifier
                // que nous n'avons pas pu trouver de champ avec ce nom.
                fieldValue = null;
                return false;
        }
    }

    /// <summary>
    /// Les sources de données enfants sont destinées aux fusions de courrier imbriquées.
    /// </summary>
    public IMailMergeDataSource GetChildDataSource(string tableName)
    {
        throw new System.NotImplementedException();
    }

    private readonly EmployeeList mEmployees;
    private int mRecordIndex;
}

Voir également

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

---

ExecuteWithRegions(DataSet)

Effectue le publipostage à partir d’unEnsemble de données dans un document avec des régions de publipostage.

public void ExecuteWithRegions(DataSet dataSet)

Paramètre	Taper	La description
dataSet	DataSet	Ensemble de données qui contient des données à insérer dans les champs de publipostage.

Remarques

Utilisez cette méthode pour effectuer un publipostage à partir d’une ou plusieurs tables vers des zones de publipostage répétables du document. Les zones de publipostage du document s’agrandissent dynamiquement pour accueillir les enregistrements des tables correspondantes.

Chaque table dans leEnsemble de données doit avoir un nom.

Le document doit avoir des régions de publipostage définies avec des noms qui font référence aux tables dans leEnsemble de données.

Pour spécifier une région de publipostage dans le document, vous devez insérer deux champs de publipostage pour marquer le début et la fin de la région de publipostage.

Tout le contenu du document inclus dans une zone de publipostage sera automatiquement répété pour chaque enregistrement de la zone.Table de données.

Pour marquer le début d’une région de publipostage, insérez un MERGEFIELD avec le nom TableStart:MyTable, où MyTable correspond à l’un des noms de table de votreEnsemble de données.

Pour marquer la fin de la région de fusion et publipostage, insérez un autre MERGEFIELD avec le nom TableEnd:MyTable.

Pour insérer un MERGEFIELD dans Word, utilisez la commande Insérer/Champ et sélectionnez MergeField, puis tapez le nom du champ.

LeTableStart etFin de table les champs doivent être à l’intérieur de la même section dans votre document.

Si utilisé à l’intérieur d’un tableau,TableStart etFin de table doit être à l’intérieur de la même ligne dans le tableau.

Les régions de publipostage dans un document doivent être bien formées (il doit toujours y avoir une paire de correspondances TableStart etFin de table fusionner les champs portant le même nom de table).

Exemples

Montre comment exécuter un publipostage imbriqué avec deux régions de fusion et deux tables de données.

public void ExecuteWithRegionsNested()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    // Normalement, les MERGEFIELD contiennent le nom d'une colonne d'une source de données de publipostage.
    // Au lieu de cela, nous pouvons utiliser les préfixes « TableStart : » et « TableEnd : » pour commencer/terminer une région de publipostage.
    // Chaque région appartiendra à une table avec un nom qui correspond à la chaîne immédiatement après les deux points du préfixe.
    builder.InsertField(" MERGEFIELD TableStart:Customers");

    // Ce MERGEFIELD se trouve à l'intérieur de la zone de fusion et de publipostage de la table « Clients ».
    // Lorsque nous exécutons le publipostage, ce champ recevra des données provenant de lignes d'une source de données nommée « Clients ».
    builder.Write("Orders for ");
    builder.InsertField(" MERGEFIELD CustomerName");
    builder.Write(":");

    // Créez des en-têtes de colonne pour une table qui contiendra des valeurs d'une deuxième région interne.
    builder.StartTable();
    builder.InsertCell();
    builder.Write("Item");
    builder.InsertCell();
    builder.Write("Quantity");
    builder.EndRow();

    // Créez une deuxième région de publipostage à l'intérieur de la région externe pour une table nommée « Commandes ».
    // La table « Commandes » a une relation plusieurs-à-un avec la table « Clients » sur la colonne « CustomerID ».
    builder.InsertCell();
    builder.InsertField(" MERGEFIELD TableStart:Orders");
    builder.InsertField(" MERGEFIELD ItemName");
    builder.InsertCell();
    builder.InsertField(" MERGEFIELD Quantity");

    // Terminez la région interne, puis la région externe. L'ouverture et la fermeture d'une région de publipostage doivent
    // se produisent sur la même ligne d'une table.
    builder.InsertField(" MERGEFIELD TableEnd:Orders");
    builder.EndTable();

    builder.InsertField(" MERGEFIELD TableEnd:Customers");

    // Créez un ensemble de données contenant les deux tables avec les noms et les relations requis.
    // Chaque document de fusion pour chaque ligne de la table « Clients » de la région de fusion externe effectuera son publipostage sur la table « Commandes ».
    // Chaque document de fusion affichera toutes les lignes de la dernière table dont les valeurs de la colonne « CustomerID » correspondent à la ligne actuelle de la table « Customers ».
    DataSet customersAndOrders = CreateDataSet();
    doc.MailMerge.ExecuteWithRegions(customersAndOrders);

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

/// <summary>
/// Génère un ensemble de données contenant deux tables de données nommées « Clients » et « Commandes », avec une relation un-à-plusieurs sur la colonne « CustomerID ».
/// </summary>
private static DataSet CreateDataSet()
{
    DataTable tableCustomers = new DataTable("Customers");
    tableCustomers.Columns.Add("CustomerID");
    tableCustomers.Columns.Add("CustomerName");
    tableCustomers.Rows.Add(new object[] { 1, "John Doe" });
    tableCustomers.Rows.Add(new object[] { 2, "Jane Doe" });

    DataTable tableOrders = new DataTable("Orders");
    tableOrders.Columns.Add("CustomerID");
    tableOrders.Columns.Add("ItemName");
    tableOrders.Columns.Add("Quantity");
    tableOrders.Rows.Add(new object[] { 1, "Hawaiian", 2 });
    tableOrders.Rows.Add(new object[] { 2, "Pepperoni", 1 });
    tableOrders.Rows.Add(new object[] { 2, "Chicago", 1 });

    DataSet dataSet = new DataSet();
    dataSet.Tables.Add(tableCustomers);
    dataSet.Tables.Add(tableOrders);
    dataSet.Relations.Add(tableCustomers.Columns["CustomerID"], tableOrders.Columns["CustomerID"]);

    return dataSet;
}

Voir également

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

---

ExecuteWithRegions(DataTable)

Effectue le publipostage à partir d’unTable de données dans le document avec les régions de publipostage.

public void ExecuteWithRegions(DataTable dataTable)

Paramètre	Taper	La description
dataTable	DataTable	Source de données pour l’opération de publipostage. La table must possède sesTableName ensemble de propriétés.

Remarques

Le document doit avoir une région de publipostage définie avec un nom correspondant à TableName.

S’il existe d’autres régions de publipostage définies dans le document, elles sont laissées intactes. Cela permet d’effectuer plusieurs opérations de publipostage.

Exemples

Montre comment formater des cellules lors d’un publipostage.

public void AlternatingRows()
{
    Document doc = new Document(MyDir + "Mail merge destination - Northwind suppliers.docx");

    doc.MailMerge.FieldMergingCallback = new HandleMergeFieldAlternatingRows();

    DataTable dataTable = GetSuppliersDataTable();
    doc.MailMerge.ExecuteWithRegions(dataTable);

    doc.Save(ArtifactsDir + "MailMergeEvent.AlternatingRows.docx");
}

/// <summary>
/// Formate les lignes du tableau lorsqu'un publipostage a lieu pour alterner entre deux couleurs sur les lignes paires/impaires.
/// </summary>
private class HandleMergeFieldAlternatingRows : IFieldMergingCallback
{
    /// <summary>
    /// Appelé lorsqu'un publipostage fusionne des données dans un MERGEFIELD.
    /// </summary>
    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        if (mBuilder == null)
            mBuilder = new DocumentBuilder(args.Document);

        // Ceci est vrai si nous sommes sur la première colonne, ce qui signifie que nous sommes passés à une nouvelle ligne.
        if (args.FieldName == "CompanyName")
        {
            Color rowColor = IsOdd(mRowIdx) ? Color.FromArgb(213, 227, 235) : Color.FromArgb(242, 242, 242);

            for (int colIdx = 0; colIdx < 4; colIdx++)
            {
                mBuilder.MoveToCell(0, mRowIdx, colIdx, 0);
                mBuilder.CellFormat.Shading.BackgroundPatternColor = rowColor;
            }

            mRowIdx++;
        }
    }

    void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
    {
        // Ne rien faire.
    }

    private DocumentBuilder mBuilder;
    private int mRowIdx;
}

/// <summary>
/// Fonction nécessaire pour le portage automatique Visual Basic qui renvoie la parité du numéro passé.
/// </summary>
private static bool IsOdd(int value)
{
    return (value / 2 * 2).Equals(value);
}

/// <summary>
/// Crée une source de données de publipostage.
/// </summary>
private static DataTable GetSuppliersDataTable()
{
    DataTable dataTable = new DataTable("Suppliers");
    dataTable.Columns.Add("CompanyName");
    dataTable.Columns.Add("ContactName");
    for (int i = 0; i < 10; i++)
    {
        DataRow datarow = dataTable.NewRow();
        dataTable.Rows.Add(datarow);
        datarow[0] = "Company " + i;
        datarow[1] = "Contact " + i;
    }

    return dataTable;
}

Montre comment utiliser les régions pour exécuter deux publipostages distincts dans un même document.

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

// Si nous voulons effectuer deux fusions de courrier consécutives sur un document tout en récupérant des données de deux tables
// liés les uns aux autres de quelque manière que ce soit, nous pouvons séparer les publipostages avec des régions.
// Normalement, les MERGEFIELD contiennent le nom d'une colonne d'une source de données de publipostage.
// Au lieu de cela, nous pouvons utiliser les préfixes « TableStart : » et « TableEnd : » pour commencer/terminer une région de publipostage.
// Chaque région appartiendra à une table avec un nom qui correspond à la chaîne immédiatement après les deux points du préfixe.
// Ces régions sont séparées pour les données non liées, tandis qu'elles peuvent être imbriquées pour les données hiérarchiques.
builder.Writeln("\tCities: ");
builder.InsertField(" MERGEFIELD TableStart:Cities");
builder.InsertField(" MERGEFIELD Name");
builder.InsertField(" MERGEFIELD TableEnd:Cities");
builder.InsertParagraph();

// Les deux MERGEFIELD font référence au même nom de colonne, mais les valeurs de chacun proviendront de tables de données différentes.
builder.Writeln("\tFruit: ");
builder.InsertField(" MERGEFIELD TableStart:Fruit");
builder.InsertField(" MERGEFIELD Name");
builder.InsertField(" MERGEFIELD TableEnd:Fruit");

// Créez deux tables de données non liées.
DataTable tableCities = new DataTable("Cities");
tableCities.Columns.Add("Name");
tableCities.Rows.Add(new object[] { "Washington" });
tableCities.Rows.Add(new object[] { "London" });
tableCities.Rows.Add(new object[] { "New York" });

DataTable tableFruit = new DataTable("Fruit");
tableFruit.Columns.Add("Name");
tableFruit.Rows.Add(new object[] { "Cherry" });
tableFruit.Rows.Add(new object[] { "Apple" });
tableFruit.Rows.Add(new object[] { "Watermelon" });
tableFruit.Rows.Add(new object[] { "Banana" });

// Nous devrons exécuter une opération de publipostage par table. La première opération de publipostage remplira les champs MERGEFIELD.
// dans la plage "Villes" tout en laissant les champs de la plage "Fruits" vides.
doc.MailMerge.ExecuteWithRegions(tableCities);

// Exécutez une deuxième fusion pour la table « Fruit », tout en utilisant une vue de données
// pour trier les lignes par ordre croissant sur la colonne « Nom » avant la fusion.
DataView dv = new DataView(tableFruit);
dv.Sort = "Name ASC";
doc.MailMerge.ExecuteWithRegions(dv);

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

Voir également

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

---

ExecuteWithRegions(DataView)

Effectue le publipostage à partir d’unVue des données dans le document avec les régions de publipostage.

public void ExecuteWithRegions(DataView dataView)

Paramètre	Taper	La description
dataView	DataView	Source de données pour l’opération de publipostage. La table source table deVue des données doit avoir sonNom de la table ensemble de propriétés.

Remarques

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

Le document doit avoir une région de publipostage définie avec un nom correspondant à DataView.Table.TableName.

S’il existe d’autres régions de publipostage définies dans le document, elles sont laissées intactes. Cela permet d’effectuer plusieurs opérations de publipostage.

Exemples

Montre comment utiliser les régions pour exécuter deux publipostages distincts dans un même document.

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

// Si nous voulons effectuer deux fusions de courrier consécutives sur un document tout en récupérant des données de deux tables
// liés les uns aux autres de quelque manière que ce soit, nous pouvons séparer les publipostages avec des régions.
// Normalement, les MERGEFIELD contiennent le nom d'une colonne d'une source de données de publipostage.
// Au lieu de cela, nous pouvons utiliser les préfixes « TableStart : » et « TableEnd : » pour commencer/terminer une région de publipostage.
// Chaque région appartiendra à une table avec un nom qui correspond à la chaîne immédiatement après les deux points du préfixe.
// Ces régions sont séparées pour les données non liées, tandis qu'elles peuvent être imbriquées pour les données hiérarchiques.
builder.Writeln("\tCities: ");
builder.InsertField(" MERGEFIELD TableStart:Cities");
builder.InsertField(" MERGEFIELD Name");
builder.InsertField(" MERGEFIELD TableEnd:Cities");
builder.InsertParagraph();

// Les deux MERGEFIELD font référence au même nom de colonne, mais les valeurs de chacun proviendront de tables de données différentes.
builder.Writeln("\tFruit: ");
builder.InsertField(" MERGEFIELD TableStart:Fruit");
builder.InsertField(" MERGEFIELD Name");
builder.InsertField(" MERGEFIELD TableEnd:Fruit");

// Créez deux tables de données non liées.
DataTable tableCities = new DataTable("Cities");
tableCities.Columns.Add("Name");
tableCities.Rows.Add(new object[] { "Washington" });
tableCities.Rows.Add(new object[] { "London" });
tableCities.Rows.Add(new object[] { "New York" });

DataTable tableFruit = new DataTable("Fruit");
tableFruit.Columns.Add("Name");
tableFruit.Rows.Add(new object[] { "Cherry" });
tableFruit.Rows.Add(new object[] { "Apple" });
tableFruit.Rows.Add(new object[] { "Watermelon" });
tableFruit.Rows.Add(new object[] { "Banana" });

// Nous devrons exécuter une opération de publipostage par table. La première opération de publipostage remplira les champs MERGEFIELD.
// dans la plage "Villes" tout en laissant les champs de la plage "Fruits" vides.
doc.MailMerge.ExecuteWithRegions(tableCities);

// Exécutez une deuxième fusion pour la table « Fruit », tout en utilisant une vue de données
// pour trier les lignes par ordre croissant sur la colonne « Nom » avant la fusion.
DataView dv = new DataView(tableFruit);
dv.Sort = "Name ASC";
doc.MailMerge.ExecuteWithRegions(dv);

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

Voir également

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

---

ExecuteWithRegions(IDataReader, string)

Effectue le publipostage à partir deIDataReader dans le document avec les régions de publipostage.

public void ExecuteWithRegions(IDataReader dataReader, string tableName)

Paramètre	Taper	La description
dataReader	IDataReader	Source des enregistrements de données pour le publipostage tels queLecteur de données OleDb ouSqlDataReader.
tableName	String	Nom de la région de publipostage dans le document à renseigner.

Remarques

Tu peux passerSqlDataReader ouLecteur de données OleDb objet dans la méthode this en tant que paramètre car ils ont tous deux été implémentésIDataReader interface.

Exemples

Montre comment insérer des images stockées dans un champ BLOB de base de données dans un rapport.

public void ImageFromBlob()
{
    Document doc = new Document(MyDir + "Mail merge destination - Northwind employees.docx");

    doc.MailMerge.FieldMergingCallback = new HandleMergeImageFieldFromBlob();

    string connString = $"Provider=Microsoft.ACE.OLEDB.12.0;Data Source={DatabaseDir + "Northwind.accdb"};";
    string query = "SELECT FirstName, LastName, Title, Address, City, Region, Country, PhotoBLOB FROM Employees";

    using (OleDbConnection conn = new OleDbConnection(connString))
    {
        conn.Open();

        // Ouvrez le lecteur de données, qui doit être dans un mode qui lit tous les enregistrements à la fois.
        OleDbCommand cmd = new OleDbCommand(query, conn);
        IDataReader dataReader = cmd.ExecuteReader();

        doc.MailMerge.ExecuteWithRegions(dataReader, "Employees");
    }

    doc.Save(ArtifactsDir + "MailMergeEvent.ImageFromBlob.docx");
}

private class HandleMergeImageFieldFromBlob : IFieldMergingCallback
{
    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        // Ne rien faire.
    }

    /// <summary>
    /// Ceci est appelé lorsqu'un publipostage rencontre un MERGEFIELD dans le document avec une balise « Image : » dans son nom.
    /// </summary>
    void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs e)
    {
        MemoryStream imageStream = new MemoryStream((byte[])e.FieldValue);
        e.ImageStream = imageStream;
    }
}

Voir également

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