OdsoFieldMapData

OdsoFieldMapData class

Anger hur en kolumn i den externa datakällan ska mappas till de fördefinierade sammanslagningsfälten i dokumentet.

public class OdsoFieldMapData

Konstruktörer

namn Beskrivning
OdsoFieldMapData() Default_Constructor

Egenskaper

namn Beskrivning
Column { get; set; } Anger det nollbaserade indexet för kolumnen inom en extern datakälla som ska mappas till det lokala namnet på ett specifikt MERGEFIELD-fält. Standardvärdet är 0.
MappedName { get; set; } Anger det fördefinierade sammanslagningsfältets namn som ska mappas till kolumnnumret som anges avColumn egenskap inom denna fältmappning. Standardvärdet är en tom sträng.
Name { get; set; } Anger kolumnnamnet inom en extern datakälla för kolumnen vars index anges avColumn property. Standardvärdet är en tom sträng.
Type { get; set; } Anger om ett givet kopplingsfält har mappats till en kolumn i den givna externa datakällan eller inte. Standardvärdet ärDefault .

Metoder

namn Beskrivning
Clone() Returnerar en djup klon av detta objekt.

Anmärkningar

Microsoft Word tillhandahåller några fördefinierade sammanslagningsfältnamn som det tillåter att infoga i ett dokument som MERGEFIELD eller använder i fälten ADDRESSBLOCK eller GREETINGLINE. Den information som anges iOdsoFieldMapData gör det möjligt att mappa en kolumn i den externa datakällan till ett enda fördefinierat sammanslagningsfält.

Exempel

Visar hur du får åtkomst till insamlingen av data som mappar datakällans kolumner för att slå samman fält.

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

// Den här samlingen definierar hur en sammanslagning kommer att mappa kolumner från en datakälla
// till fördefinierade fält MERGEFIELD, ADDRESSBLOCK och 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.");
    }
}

// Klona elementen i den här samlingen.
Assert.AreNotEqual(dataCollection[0], dataCollection[0].Clone());

// Använd "RemoveAt"-metodens element individuellt efter index.
dataCollection.RemoveAt(0);

Assert.AreEqual(29, dataCollection.Count);

// Använd "Rensa"-metoden för att rensa hela samlingen på en gång.
dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

Se även