OdsoRecipientData

OdsoRecipientData class

Representa información sobre un único 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 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 se utiliza Microsoft WordHash 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 combinado, entonces no se necesita información sobre ese registro. Sin embargo, si un registro determinado no se fusionará en un documento combinado, entonces el valor de la clave única para ese registro se almacenará en elUniqueTagpropiedad 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 a la vez.
dataCollection.RemoveAt(0);

Assert.AreEqual(69, dataCollection.Count);

dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Ver también

OdsoFieldMappingType Enum OdsoRecipientDataCollection Class