OdsoFieldMapData

OdsoFieldMapData class

Especifica cómo se asignará una columna en la fuente de datos externa a los campos de combinación predefinidos dentro del documento.

public class OdsoFieldMapData

Constructores

Nombre Descripción
OdsoFieldMapData() Constructor predeterminado

Propiedades

Nombre Descripción
Column { get; set; } Especifica el índice de base cero de la columna dentro de una fuente de datos externa que se asignará al nombre local de un campo MERGEFIELD específico. El valor predeterminado es 0.
MappedName { get; set; } Especifica el nombre de campo de combinación predefinido que se asignará al número de columna especificado por elColumn propiedad dentro de esta asignación de campo. El valor predeterminado es una cadena vacía.
Name { get; set; } Especifica el nombre de columna dentro de un origen de datos externo para la columna cuyo índice está especificado por elColumn property. El valor predeterminado es una cadena vacía.
Type { get; set; } Especifica si un campo de combinación de correo dado se ha asignado a una columna en la fuente de datos externa dada o no. El valor predeterminado esDefault .

Métodos

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

Observaciones

Microsoft Word proporciona algunos nombres de campos de combinación predefinidos que permite insertar en un documento como MERGEFIELD o en los campos ADRESSBLOCK o GREETINGLINE. La información especificada enOdsoFieldMapData permite asignar una columna en la fuente de datos externa a un solo campo de combinación predefinido.

Ejemplos

Muestra cómo acceder a la colección de datos que asigna columnas de fuentes de datos a campos combinados.

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

// Esta colección define cómo una combinación de correo mapeará las columnas de una fuente de datos
// a los campos MERGEFIELD, ADRESSBLOCK y GREETINGLINE predefinidos.
OdsoFieldMapDataCollection dataCollection = doc.MailMergeSettings.Odso.FieldMapDatas;
Assert.AreEqual(30, dataCollection.Count);

using (IEnumerator<OdsoFieldMapData> enumerator = dataCollection.GetEnumerator())
{
    int index = 0;
    while (enumerator.MoveNext())
    {
        Console.WriteLine($"Field map data index {index++}, type \"{enumerator.Current.Type}\":");

        Console.WriteLine(
            enumerator.Current.Type != OdsoFieldMappingType.Null
                ? $"\tColumn \"{enumerator.Current.Name}\", number {enumerator.Current.Column} mapped to merge field \"{enumerator.Current.MappedName}\"."
                : "\tNo valid column to field mapping data present.");
    }
}

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

// Usar los elementos del método "RemoveAt" individualmente por índice.
dataCollection.RemoveAt(0);

Assert.AreEqual(29, dataCollection.Count);

// Use el método "Borrar" para borrar toda la colección a la vez.
dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Ver también