OdsoFieldMapData

OdsoFieldMapData class

Gibt an, wie eine Spalte in der externen Datenquelle den vordefinierten Seriendruckfeldern im Dokument zugeordnet werden soll.

Um mehr zu erfahren, besuchen Sie dieSerienbriefe und Berichte Dokumentationsartikel.

public class OdsoFieldMapData

Konstrukteure

NameBeschreibung
OdsoFieldMapData()Default_Constructor

Eigenschaften

NameBeschreibung
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 Seriendruckfeldnamen an, der der Spaltennummer zugeordnet werden soll, die durch denColumn 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 denColumnproperty. Der Standardwert ist eine leere Zeichenfolge.
Type { get; set; }Gibt an, ob ein bestimmtes Serienbrieffeld einer Spalte in der angegebenen externen Datenquelle zugeordnet wurde oder nicht. Der Standardwert istDefault .

Methoden

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

Bemerkungen

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

Beispiele

Zeigt, wie auf die Datensammlung zugegriffen wird, die Datenquellenspalten Seriendruckfeldern zuordnet.

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

// Diese Sammlung definiert, wie ein Serienbrief Spalten aus einer Datenquelle abbildet
// zu vordefinierten MERGEFIELD-, ADDRESSBLOCK- 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.");
    }
}

// Klonen Sie die Elemente in dieser Sammlung.
Assert.AreNotEqual(dataCollection[0], dataCollection[0].Clone());

// Verwenden Sie die Elemente der Methode „RemoveAt“ einzeln nach Index.
dataCollection.RemoveAt(0);

Assert.AreEqual(29, dataCollection.Count);

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

Assert.AreEqual(0, dataCollection.Count);

Siehe auch

OdsoDataSourceType Enum OdsoFieldMapDataCollection Class