OdsoRecipientData

OdsoRecipientData class

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

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

public class OdsoRecipientData

Constructeurs

NomLa description
OdsoRecipientData()Default_Constructor

Propriétés

NomLa description
Active { get; set; }Spécifie si l’enregistrement de la source de données doit être importé dans un document lors du publipostage. La valeur par défaut estvrai .
Column { get; set; }Spécifie la colonne de 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. Parfois, Microsoft Word utiliseHash d’un enregistrement entier au lieu d’unUniqueTag value. 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

NomLa 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. Cependant, si un enregistrement donné ne doit pas être fusionné dans un document fusionné, alors la valeur de la clé unique pour cet enregistrement doit être stockée dans leUniqueTagproprié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 même temps.
dataCollection.RemoveAt(0);

Assert.AreEqual(69, dataCollection.Count);

dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Voir également

OdsoFieldMappingType Enum OdsoRecipientDataCollection Class