OdsoFieldMapData

OdsoFieldMapData class

Spécifie comment une colonne de la source de données externe doit être mappée aux champs de fusion prédéfinis dans le document.

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

public class OdsoFieldMapData

Constructeurs

NomLa description
OdsoFieldMapData()Default_Constructor

Propriétés

NomLa description
Column { get; set; }Spécifie l’index de base zéro de la colonne dans une source de données externe qui doit être mappé au nom local d’un champ MERGEFIELD spécifique. La valeur par défaut est 0.
MappedName { get; set; }Spécifie le nom du champ de fusion prédéfini qui doit être mappé au numéro de colonne spécifié par leColumn propriété dans ce champ mapping. La valeur par défaut est une chaîne vide.
Name { get; set; }Spécifie le nom de colonne dans une source de données externe pour la colonne dont l’index est spécifié par leColumnproperty. La valeur par défaut est une chaîne vide.
Type { get; set; }Spécifie si un champ de publipostage donné a été mappé à une colonne dans la source de données externe donnée ou non. La valeur par défaut estDefault .

Méthodes

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

Remarques

Microsoft Word fournit des noms de champs de fusion prédéfinis qu’il permet d’insérer dans un document en tant qu’utilisation MERGEFIELD ou dans les champs ADDRESSBLOCK ou GREETINGLINE. Les informations spécifiées dansOdsoFieldMapData permet de mapper une colonne de la source de données externe à un seul champ de fusion prédéfini.

Exemples

Montre comment accéder à la collection de données qui mappe les colonnes de la source de données aux champs de fusion.

Document doc = new Document(MyDir + "Odso data.docx");

// Cette collection définit comment un publipostage mappera les colonnes d'une source de données
// aux champs prédéfinis MERGEFIELD, ADDRESSBLOCK et GREETINGLINE.
OdsoFieldMapDataCollection dataCollection = doc.MailMergeSettings.Odso.FieldMapDatas;
Assert.AreEqual(30, dataCollection.Count);

using (IEnumerator<OdsoFieldMapData> enumerator = dataCollection.GetEnumerator())
{
    int index = 0;
    while (enumerator.MoveNext())
    {
        Console.WriteLine($"Field map data index {index++}, type \"{enumerator.Current.Type}\":");

        Console.WriteLine(
            enumerator.Current.Type != OdsoFieldMappingType.Null
                ? $"\tColumn \"{enumerator.Current.Name}\", number {enumerator.Current.Column} mapped to merge field \"{enumerator.Current.MappedName}\"."
                : "\tNo valid column to field mapping data present.");
    }
}

// Clonez les éléments de cette collection.
Assert.AreNotEqual(dataCollection[0], dataCollection[0].Clone());

// Utilisez les éléments de la méthode "RemoveAt" individuellement par index.
dataCollection.RemoveAt(0);

Assert.AreEqual(29, dataCollection.Count);

// Utilisez la méthode "Clear" pour effacer toute la collection en une seule fois.
dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Voir également