OdsoRecipientData

OdsoRecipientData class

Représente des informations sur un seul enregistrement dans une source de données externe qui doit être exclue du publipostage.

public class OdsoRecipientData

Constructeurs

Nom La description
OdsoRecipientData() Default_Constructor

Propriétés

Nom La description
Active { get; set; } Spécifie si l’enregistrement de la source de données doit être importé dans un document lorsque le publipostage est effectué. La valeur par défaut estvrai .
Column { get; set; } Spécifie la colonne dans la source de données qui contient des données uniques pour l’enregistrement actuel. La valeur par défaut est 0.
Hash { get; set; } Représente le code de hachage de cet enregistrement. Microsoft Word utilise parfoisHash d’un enregistrement entier au lieu d’unUniqueTag valeur. La valeur par défaut est 0.
UniqueTag { get; set; } Spécifie le contenu d’un enregistrement donné dans la colonne contenant des données uniques. La valeur par défaut estnul .

Méthodes

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

Remarques

Si un enregistrement doit être fusionné dans un document fusionné, aucune information n’est nécessaire sur cet enregistrement. Toutefois, si un enregistrement donné ne doit pas être fusionné dans un document fusionné, la valeur de la clé unique pour cet enregistrement doit être stockée dans leUniqueTag propriété de cet objet pour indiquer cette exclusion.

Exemples

Montre comment accéder à la collection de données qui désigne les enregistrements de source de données de fusion qu’un publipostage exclura.

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

OdsoRecipientDataCollection dataCollection = doc.MailMergeSettings.Odso.RecipientDatas;

Assert.AreEqual(70, dataCollection.Count);

using (IEnumerator<OdsoRecipientData> enumerator = dataCollection.GetEnumerator())
{
    int index = 0;
    while (enumerator.MoveNext())
    {
        Console.WriteLine(
            $"Odso recipient data index {index++} will {(enumerator.Current.Active ? "" : "not ")}be imported upon mail merge.");
        Console.WriteLine($"\tColumn #{enumerator.Current.Column}");
        Console.WriteLine($"\tHash code: {enumerator.Current.Hash}");
        Console.WriteLine($"\tContents array length: {enumerator.Current.UniqueTag.Length}");
    }
}

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

// Nous pouvons également supprimer des éléments individuellement ou effacer toute la collection en une seule fois.
dataCollection.RemoveAt(0);

Assert.AreEqual(69, dataCollection.Count);

dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Voir également