Verwenden der punktierten Schreibweise im Business Data Connectivity-Dienst (BDC)
Letzte Änderung: Montag, 19. April 2010
Gilt für: SharePoint Server 2010
Inhalt dieses Artikels
Beispiel 1: Verweisen auf ein Feld eines komplexen Typs
Beispiel 2: Zugreifen auf Auflistungen
Beispiel 3: Verweisen auf Felder mit Sonderzeichen
Eine von einem externen System zurückgegebene Datenstruktur kann komplexe Strukturen mit mehreren Datenelementebenen enthalten. Im Business Data Connectivity-Dienst (BDC) kann mithilfe der punktierten Schreibweise auf jede Datenelementebene zugegriffen werden. Die punktierte Schreibweise ist eine Darstellung der Datenelemente, ähnlich dem Zugriff auf Datenelemente in C#. Für den Zugriff auf ein Datenelement geben Sie das übergeordnete Datenelement und den Namen des Datenelements an, falls das enthaltende Datenelement eine Struktur ist, oder aber den Index des Datenelements, falls das enthaltende Element eine Auflistung ist. Im Folgenden finden Sie Beispiele für die Verwendung der punktierten Schreibweise.
Beispiel 1: Verweisen auf ein Feld eines komplexen Typs
Stellen Sie sich die Struktur Customer als externes Element mit den folgenden Feldern vor:
CustomerID
Name
PhoneNumber
Address
Street
City
State
Zip
Das Feld Address ist ein komplexer Typ. Angenommen, Sie möchten die folgenden Felder des externen Elements Customer anzeigen:
Name
PhoneNumber
City
State
In diesem Fall können Sie diese Felder wie im folgenden Code dargestellt mithilfe des Indexers in der IEntityInstance-Schnittstelle abrufen.
IEntityInstance customerItem = customerEntity.FindSpecific (...);
customerItem["Name"]
customerItem["PhoneNumber"]
customerItem["Address.City"]
customerItem["Address.State"]
Beispiel 2: Zugreifen auf Auflistungen
Sie können mit BDC auch auf Member in Auflistungen verweisen. Stellen Sie sich die Struktur Customer mit den folgenden Feldern vor:
CustomerID
Name
PhoneNumber
Addresses (eine Auflistung von Address-Elementen)
Address
Street
City
State
Zip
Die Struktur Customer in diesem Beispiel enthält eine Address-Auflistung. Angenommen, die erste Adresse in der Auflistung ist die primäre Adresse und Sie möchten die folgenden Felder des externen Elements Customer anzeigen:
CustomerID
Name
PhoneNumber
PrimaryAddressCity
PrimaryAddressState
In diesem Fall können Sie wie im folgenden Code dargestellt im Rückgabeparameter der SpecificFinder-Methodeninstanz auf die Unterfelder City und State der Struktur Customer verweisen.
Customer.Addresses[0].City
Customer.Addresses[0].State
Beispiel 3: Verweisen auf Felder mit Sonderzeichen
Wenn der Name eines der Sonderzeichen umgekehrter Schrägstrich ("\"), Punkt (".") oder eckige Klammer ("[") enthält, muss das Sonderzeichen mit Escapezeichen in Form von "\" versehen werden.
Stellen Sie sich die Struktur Customer mit den folgenden Feldern vor:
CustomerID
Name
PhoneNumber
Address
Street
House\PropertyNo
City
State
Zip
Das Feld House\PropertyNo enthält das Sonderzeichen "\". Angenommen, Sie möchten die folgenden Felder des externen Elements Customer anzeigen:
CustomerID
Name
PhoneNumber
House\PropertyNo
City
State
In diesem Fall können Sie wie im folgenden Code dargestellt im Rückgabeparameter der SpecificFinder-Methodeninstanz auf das Unterfeld House\PropertyNo der Struktur Customer verweisen:
Customer.Address.House\\PropertyNo