OdsoFieldMapData

OdsoFieldMapData class

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

För att lära dig mer, besökKoppla dokument och rapportering dokumentationsartikel.

public class OdsoFieldMapData

Konstruktörer

namnBeskrivning
OdsoFieldMapData()Default_Constructor

Egenskaper

namnBeskrivning
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 kopplingsfältnamnet 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 i en extern datakälla för den kolumn vars -index anges avColumnproperty. Standardvärdet är en tom sträng.
Type { get; set; }Anger om ett givet fält för koppling av dokument har mappats till en kolumn i den angivna externa datakällan eller inte. Standardvärdet ärDefault .

Metoder

namnBeskrivning
Clone()Returnerar en djup klon av detta objekt.

Anmärkningar

Microsoft Word tillhandahåller några fördefinierade namn på kopplingsfält som det gör att man kan infoga i ett dokument som MERGEFIELD eller i fälten ADRESSBLOCK eller HÄLSNINGSLINJE. Informationen som anges iOdsoFieldMapData gör det möjligt att mappa en kolumn i den externa datakällan till ett enda fördefinierat kopplingsfält.

Exempel

Visar hur man kommer åt datasamlingen som mappar datakällkolumner till kopplingsfält.

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

// Denna samling definierar hur en dokumentkoppling mappar kolumner från en datakälla
// till fördefinierade fält MERGEFIELD, ADDRESSBLOCK och GREETEINGLINE.
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 metodelementen "RemoveAt" individuellt efter index.
dataCollection.RemoveAt(0);

Assert.AreEqual(29, dataCollection.Count);

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

Assert.AreEqual(0, dataCollection.Count);

Se även

OdsoDataSourceType Enum OdsoFieldMapDataCollection Class