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.

public class OdsoRecipientData

Constructores

Nombre Descripción
OdsoRecipientData() Constructor predeterminado

Propiedades

Nombre Descripción
Active { get; set; } Especifica si el registro del origen de datos se importará a un documento cuando se realice 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 usaHash de un registro completo en lugar de unUniqueTag value. El valor predeterminado es 0.
UniqueTag { get; set; } Especifica el contenido de un registro dado en la columna que contiene datos únicos. El valor predeterminado esnulo .

Métodos

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

Observaciones

Si un registro debe fusionarse en un documento fusionado, entonces no se necesita información sobre ese registro. Sin embargo, si un registro dado no debe fusionarse en un documento fusionado, entonces el valor de la clave única para ese registro se almacenará en elUniqueTag propiedad 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 combinados 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 a la vez.
dataCollection.RemoveAt(0);

Assert.AreEqual(69, dataCollection.Count);

dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Ver también