OdsoFieldMapData

OdsoFieldMapData class

Gibt an, wie eine Spalte in der externen Datenquelle den vordefinierten Briefvorlagenfeldern innerhalb des Dokuments zugeordnet werden soll.

public class OdsoFieldMapData

Konstrukteure

Name Beschreibung
OdsoFieldMapData() Default_Constructor

Eigenschaften

Name Beschreibung
Column { get; set; } Gibt den nullbasierten Index der Spalte innerhalb einer externen Datenquelle an, die dem lokalen Namen eines bestimmten MERGEFIELD-Felds zugeordnet werden soll. Der Standardwert ist 0.
MappedName { get; set; } Gibt den vordefinierten Briefvorlagenfeldnamen an, der der Spaltennummer zugeordnet werden soll, die durch angegeben wirdColumn Eigenschaft innerhalb dieser Feldzuordnung. Der Standardwert ist eine leere Zeichenfolge.
Name { get; set; } Gibt den Spaltennamen innerhalb einer externen Datenquelle für die Spalte an, deren -Index durch angegeben wirdColumn property. Der Standardwert ist eine leere Zeichenfolge.
Type { get; set; } Gibt an, ob ein bestimmtes Seriendruckfeld einer Spalte in der angegebenen externen Datenquelle zugeordnet wurde oder nicht. Der Standardwert istDefault .

Methoden

Name Beschreibung
Clone() Gibt einen tiefen Klon dieses Objekts zurück.

Bemerkungen

Microsoft Word stellt einige vordefinierte Briefvorlagenfeldnamen bereit, die in ein Dokument als MERGEFIELD oder eingefügt werden können, die in den Feldern ADDRESSBLOCK oder GREETINGLINE verwendet werden. Die Angaben inOdsoFieldMapData ermöglicht die Zuordnung einer Spalte in der externen Datenquelle zu einem einzelnen vordefinierten Briefvorlagenfeld.

Beispiele

Zeigt, wie auf die Sammlung von Daten zugegriffen wird, die Datenquellenspalten Briefvorlagenfeldern zuordnet.

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

// Diese Sammlung definiert, wie ein Seriendruck Spalten aus einer Datenquelle zuordnet
// zu vordefinierten MERGEFIELD-, ADRESSBLOCK- und GREETINGLINE-Feldern.
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.");
    }
}

// Die Elemente in dieser Sammlung klonen.
Assert.AreNotEqual(dataCollection[0], dataCollection[0].Clone());

// Verwenden Sie die "RemoveAt"-Methodenelemente einzeln nach Index.
dataCollection.RemoveAt(0);

Assert.AreEqual(29, dataCollection.Count);

// Verwenden Sie die "Clear"-Methode, um die gesamte Sammlung auf einmal zu löschen.
dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Siehe auch