Freigeben über


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