OdsoFieldMapData

OdsoFieldMapData class

Specifica come una colonna nell’origine dati esterna deve essere mappata ai campi di unione predefiniti all’interno del documento.

public class OdsoFieldMapData

Costruttori

Nome Descrizione
OdsoFieldMapData() Default_Costruttore

Proprietà

Nome Descrizione
Column { get; set; } Specifica l’indice in base zero della colonna all’interno di un’origine dati esterna che deve essere mappato al nome locale di un campo MERGEFIELD specifico. Il valore predefinito è 0.
MappedName { get; set; } Specifica il nome del campo di unione predefinito che deve essere mappato al numero di colonna specificato dalColumn proprietà all’interno di questo campo mappatura. Il valore predefinito è una stringa vuota.
Name { get; set; } Specifica il nome della colonna all’interno di un’origine dati esterna per la colonna il cui indice è specificato dalColumn proprietà. Il valore predefinito è una stringa vuota.
Type { get; set; } Specifica se un determinato campo di stampa unione è stato mappato a una colonna nell’origine dati esterna specificata o meno. Il valore predefinito èDefault .

Metodi

Nome Descrizione
Clone() Restituisce un clone profondo di questo oggetto.

Osservazioni

Microsoft Word fornisce alcuni nomi di campi di unione predefiniti che consente di inserire in un documento come MERGEFIELD o utilizzare nei campi ADDRESSBLOCK o GREETINGLINE. Le informazioni specificate inOdsoFieldMapData consente di mappare una colonna nell’origine dati esterna a un singolo campo di unione predefinito.

Esempi

Mostra come accedere alla raccolta di dati che mappa le colonne dell’origine dati per unire i campi.

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

// Questa raccolta definisce come una stampa unione mapperà le colonne da un'origine dati
// ai campi MERGEFIELD, ADDRESSBLOCK e 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 gli elementi in questa raccolta.
Assert.AreNotEqual(dataCollection[0], dataCollection[0].Clone());

// Usa gli elementi del metodo "RemoveAt" individualmente per indice.
dataCollection.RemoveAt(0);

Assert.AreEqual(29, dataCollection.Count);

// Usa il metodo "Cancella" per cancellare l'intera collezione in una volta.
dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Guarda anche