OdsoFieldMapData

OdsoFieldMapData class

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

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

public class OdsoFieldMapData

Constructores

NombreDescripción
OdsoFieldMapData()Constructor predeterminado

Propiedades

NombreDescripció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 del campo de combinación predefinido que se asignará al número de columna especificado porColumn propiedad dentro de esta asignación de campos. El valor predeterminado es una cadena vacía.
Name { get; set; }Especifica el nombre de la columna dentro de una fuente de datos externa para la columna cuyo índice está especificado por elColumnpropiedad. El valor predeterminado es una cadena vacía.
Type { get; set; }Especifica si un campo de combinación de correspondencia determinado se ha asignado a una columna en la fuente de datos externa determinada o no. El valor predeterminado esDefault .

Métodos

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

Observaciones

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

Ejemplos

Muestra cómo acceder a la colección de datos que asigna columnas de origen de datos para fusionar campos.

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

// Esta colección define cómo una combinación de correspondencia asignará columnas de una fuente de datos
// a los campos predefinidos MERGEFIELD, ADDRESSBLOCK y GREETINGLINE.
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());

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

Assert.AreEqual(29, dataCollection.Count);

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

Assert.AreEqual(0, dataCollection.Count);

Ver también

OdsoDataSourceType Enum OdsoFieldMapDataCollection Class