Freigeben über

Gewusst wie: Definieren des Typdeskriptors für einen Parameter

  • Artikel

Ein Typdeskriptor enthält Eigenschaften, mit denen der Datentyp eines Parameters beschrieben wird. Von einem Typdeskriptor kann ein Feld, eine Entität oder eine Auflistung von Entitäten definiert werden. Weitere Informationen finden Sie unter Typdeskriptor.

So definieren Sie den Typdeskriptor für einen Parameter

  1. Wählen Sie im Fenster BDC-Methodendetails den Typdeskriptor des Parameters aus.

  2. Klicken Sie im Menü Ansicht auf Eigenschaftenfenster.

  3. Legen Sie im Eigenschaftenfenster die Eigenschaften des Typdeskriptors fest.

    In den folgenden Prozeduren wird beschrieben, wie ein Typdeskriptor als Feld, Entität oder Entitätsauflistung definiert wird.

So definieren Sie ein Feld

  1. Legen Sie im Eigenschaftenfenster die Eigenschaft Name des Typdeskriptors auf den Namen eines Felds im Typ fest, der die Entität darstellt (beispielsweise "FirstName").

  2. Klicken Sie neben der Eigenschaft TypeName auf die Dropdownliste, und wählen Sie den entsprechenden Datentyp (beispielsweise Int32) aus.

    Informationen zu anderen optionalen Parametern finden Sie unter Typdeskriptor.

So definieren Sie eine Entität

  1. Legen Sie im Eigenschaftenfenster die Eigenschaft Name auf einen aussagekräftigen Namen für die Entität fest (beispielsweise "Kontakt").

  2. Legen Sie die Eigenschaft TypeName auf den vollqualifizierten Namen des Typs fest, der die Entität darstellt. Bei diesem Typ kann es sich um eine Klasse im Projekt, um einen im BDC-Objektmodell definierten Typ oder um einen Typ handeln, der in einer Assembly definiert ist, auf die in der Lösung verwiesen wird.

    • Klicken Sie bei Verwendung einer Klasse im Projekt auf die Dropdownliste, die neben der Eigenschaft TypeName angezeigt wird, klicken Sie auf die Registerkarte Aktuelles Projekt, und wählen Sie eine Klasse im Projekt aus.

      Der vollqualifizierte Name enthält den Namespace und den Namen der Klasse, gefolgt vom Namen des LOB-Systems. Im folgenden Beispiel wird der Wert der Eigenschaft TypeName auf eine Klasse im Projekt festgelegt.

      MyBDCNamespace.BdcModel1.Contact, BdcModel1

    • Bei Verwendung eines Typs, der sich in einer Assembly der Lösung befindet, enthält der vollqualifizierte Name den Namen des Typs, den Namen der Assembly, die Versionsnummer, die Kultur sowie das öffentliche Schlüsseltoken.

      Im folgenden Beispiel wird der Wert der Eigenschaft TypeName auf einen Typ festgelegt, der in einer Assembly definiert ist, auf die in der Lösung verwiesen wird.

      MyNamespace.Contact, myAssemblyName, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089

    • Bei Verwendung eines im BDC-Objektmodell definierten Typs enthält der vollqualifizierte Name den Namespace und den Namen des Typs.

      Im folgenden Beispiel wird der Wert der Eigenschaft TypeName auf einen Typ im BDC-Objektmodell festgelegt.

      Microsoft.BusinessData.Runtime.DynamicType

  3. Klicken Sie im Fenster BDC-Methodendetails auf die Dropdownliste, die für den Typdeskriptor angezeigt wird, und klicken Sie anschließend auf Bearbeiten.

    Das Fenster BDC-Explorer wird geöffnet.

  4. Klicken Sie im BDC-Explorer mit der rechten Maustaste auf den Typdeskriptor, und klicken Sie anschließend auf Typdeskriptor hinzufügen.

    Dem Entitätstypdeskriptor wird ein neuer Typdeskriptor als untergeordnetes Element hinzugefügt. Konfigurieren Sie diesen Typdeskriptor als Feld.

  5. Wiederholen Sie Schritt 4, um für jedes Feld der Entität einen untergeordneten Typdeskriptor hinzuzufügen.

So definieren Sie eine Auflistung von Entitäten

  1. Wählen Sie im Fenster BDC-Methodendetails den Typdeskriptor des gewünschten Parameters aus.

  2. Klicken Sie im Menü Ansicht auf Eigenschaftenfenster.

  3. Legen Sie im Eigenschaftenfenster die Eigenschaft Name auf einen aussagekräftigen Namen für die Entität fest (beispielsweise "Kontakte").

  4. Legen Sie die Eigenschaft IsCollection auf True fest. Dadurch wird angegeben, dass es sich bei diesem Typdeskriptor um eine Auflistung von Entitäten handelt.

  5. Legen Sie die Eigenschaft TypeName auf eine Zeichenfolge fest, die einen Verweis auf die IEnumerable<T>-Schnittstelle und den vollqualifizierten Namen des Typs enthält, der die Entität darstellt. Bei diesem Typ kann es sich um eine Klasse im Projekt, um einen im BDC-Objektmodell definierten Typ oder um einen Typ handeln, der in einer Assembly definiert ist, auf die in der Lösung verwiesen wird.

    • Klicken Sie bei Verwendung einer Klasse im Projekt auf die Dropdownliste, die neben der Eigenschaft TypeName angezeigt wird, klicken Sie auf die Registerkarte Aktuelles Projekt, und wählen Sie eine Klasse im Projekt aus.

      Der vollqualifizierte Name enthält den Namespace und den Namen der Klasse, gefolgt vom Namen des LOB-Systems.

      Im folgenden Beispiel wird der Wert der Eigenschaft TypeName auf eine Auflistung von Klassen im Projekt festgelegt.

      System.Collections.Generic.IEnumerable`1 [MyBDCNamespace. BdcModel1.Contact, BdcModel1]

    • Bei Verwendung eines Typs, der sich in einer Assembly der Lösung befindet, enthält der vollqualifizierte Name den Namen des Typs, den Namen der Assembly, die Versionsnummer, die Kultur sowie das öffentliche Schlüsseltoken.

      Im folgenden Beispiel wird der Wert der Eigenschaft TypeName auf eine Auflistung von Typen in einer Assembly festgelegt, auf die in der Lösung verwiesen wird.

      System.Collections.Generic.IEnumerable`1 [MyNamespace.Contact, myAssemblyName, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]

    • Bei Verwendung eines im BDC-Objektmodell definierten Typs enthält der vollqualifizierte Name lediglich den Namespace und den Namen des Typs.

      Im folgenden Beispiel wird der Wert der Eigenschaft TypeName auf eine Auflistung von im BDC-Objektmodell definierten Typen festgelegt.

      System.Collections.Generic.IEnumerable`1 [Microsoft.BusinessData.Runtime.DynamicType]

  6. Klicken Sie im Fenster BDC-Methodendetails auf die Dropdownliste, die für den Typdeskriptor angezeigt wird, und klicken Sie anschließend auf Bearbeiten.

    Das Fenster BDC-Explorer wird geöffnet.

  7. Klicken Sie im BDC-Explorer mit der rechten Maustaste auf den Typdeskriptor, und klicken Sie anschließend auf Typdeskriptor hinzufügen.

    Dem Auflistungstypdeskriptor wird ein neuer Typdeskriptor als untergeordnetes Element hinzugefügt. Konfigurieren Sie diesen Typdeskriptor als Entität.

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen einer Entität zu einem Modell

Gewusst wie: Hinzufügen eines Parameters zu einer Methode

Gewusst wie: Definieren einer Methodeninstanz

Konzepte

Übersicht über Entwurfstools für BDC-Modelle

Weitere Ressourcen

Entwerfen eines Business Data Connectivity-Modells