GetChildDataSource

IMailMergeDataSource.GetChildDataSource method

Le moteur de publipostage Aspose.Words appelle cette méthode lorsqu’il rencontre le début d’une région de publipostage imbriquée.

public IMailMergeDataSource GetChildDataSource(string tableName)
ParamètreTaperLa description
tableNameStringNom de la région de publipostage tel que spécifié dans le document modèle. Insensible à la casse.

Return_Value

Un objet source de données qui donnera accès aux enregistrements de données de la table spécifiée.

Remarques

Lorsque les moteurs de publipostage Aspose.Words remplissent une région de publipostage avec des données et rencontrent le début d’une région de publipostage imbriquée sous la forme de MERGEFIELD TableStart:TableName, il invoqueGetChildDataSource sur l’objet source de données current . Votre implémentation doit renvoyer un nouvel objet source de données qui donnera accès aux enregistrements child de l’enregistrement parent actuel. Aspose.Words utilisera la source de données renvoyée pour remplir la région de publipostage imbriquée.

Vous trouverez ci-dessous les règles que la mise en œuvre deGetChildDataSource doit suivre.

Si la table représentée par cet objet source de données a une table enfant (détail) associée avec le nom spécifié, alors votre implémentation doit renvoyer un nouveauIMailMergeDataSourceobjet qui fournira access aux enregistrements enfants de l’enregistrement actuel. Un exemple de ceci est la relation Orders / OrderDetails. Supposons que le courantIMailMergeDataSource object représente la table Commandes et possède un enregistrement de commande actuel. Ensuite, Aspose.Words rencontre “MERGEFIELD TableStart:OrderDetails” dans le document et invoqueGetChildDataSource . Vous devez créer et renvoyer unIMailMergeDataSource Objet qui permettra à Aspose.Words d’accéder à l’enregistrement OrderDetails pour la commande en cours.

Si cet objet source de données n’a pas de relation avec la table portant le nom spécifié, vous devez alors renvoyer unIMailMergeDataSource objet qui donnera accès à tous les enregistrements de la table spécifiée.

Si une table portant le nom spécifié n’existe pas, votre implémentation doit renvoyernul .

Exemples

Montre comment exécuter un publipostage avec une source de données sous la forme d’un objet personnalisé.

public void CustomDataSource()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);
    builder.InsertField(" MERGEFIELD FullName ");
    builder.InsertParagraph();
    builder.InsertField(" MERGEFIELD Address ");

    List<Customer> customers = new List<Customer>
    {
        new Customer("Thomas Hardy", "120 Hanover Sq., London"),
        new Customer("Paolo Accorti", "Via Monte Bianco 34, Torino")
    };

     // Pour utiliser un objet personnalisé comme source de données, il doit implémenter l'interface IMailMergeDataSource.
    CustomerMailMergeDataSource dataSource = new CustomerMailMergeDataSource(customers);

    doc.MailMerge.Execute(dataSource);

    doc.Save(ArtifactsDir + "MailMergeCustom.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;
    }

    public string FullName { get; set; }
    public string Address { 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(List<Customer> customers)
    {
        mCustomers = customers;

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

    /// <summary>
    /// Le nom de la source de données. Utilisé par Aspose.Words uniquement lors de l’exécution d’un publipostage avec des régions répétables.
    /// </summary>
    public string TableName
    {
        get { return "Customer"; }
    }

    /// <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;
            default:
                // Renvoie "false" au moteur de publipostage Aspose.Words pour signifier
                // que nous n'avons pas trouvé de champ portant ce nom.
                fieldValue = null;
                return false;
        }
    }

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

        return !IsEof;
    }

    public IMailMergeDataSource GetChildDataSource(string tableName)
    {
        return null;
    }

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

    private readonly List<Customer> mCustomers;
    private int mRecordIndex;
}

Voir également

IMailMergeDataSource.TableName IMailMergeDataSource.GetValue