OdsoRecipientData

OdsoRecipientData class

Representa información sobre un solo registro dentro de una fuente de datos externa que se excluirá de la combinación de correspondencia.

Para obtener más información, visite elCombinación de correspondencia e informes Artículo de documentación.

public class OdsoRecipientData

Constructores

NombreDescripción
OdsoRecipientData()Constructor predeterminado

Propiedades

NombreDescripción
Active { get; set; }Especifica si el registro de la fuente de datos se importará a un documento cuando se realiza la combinación de correspondencia. El valor predeterminado esverdadero .
Column { get; set; }Especifica la columna dentro de la fuente de datos que contiene datos únicos para el registro actual. El valor predeterminado es 0.
Hash { get; set; }Representa el código hash de este registro. A veces Microsoft Word utilizaHash de un registro completo en lugar de unUniqueTag valor. El valor predeterminado es 0.
UniqueTag { get; set; }Especifica el contenido de un registro determinado en la columna que contiene datos únicos. El valor predeterminado esnulo .

Métodos

NombreDescripción
Clone()Devuelve un clon profundo de este objeto.

Observaciones

Si un registro se fusionará en un documento fusionado, no se necesitará información sobre ese registro. Sin embargo, si un registro determinado no se fusionará en un documento fusionado, entonces el valor de la clave única para ese registro se almacenará en laUniqueTagpropiedad de este objeto para indicar esta exclusión.

Ejemplos

Muestra cómo acceder a la colección de datos que designa qué registros de origen de datos de combinación excluirá una combinación de correspondencia.

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}");
    }
}

//Podemos clonar los elementos de esta colección.
Assert.AreNotEqual(dataCollection[0], dataCollection[0].Clone());

// También podemos eliminar elementos individualmente o borrar toda la colección de una vez.
dataCollection.RemoveAt(0);

Assert.AreEqual(69, dataCollection.Count);

dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Ver también

OdsoFieldMappingType Enum OdsoRecipientDataCollection Class