Freigeben über


Gewusst wie: Definieren des Typdeskriptors für einen Parameter

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. BDC-Methodendetails wählen Sie im Fenster den Typdeskriptor des Parameters aus.

  2. Wählen Sie auf der Menüleiste die Optionen Ansicht und Eigenschaftenfenster aus.

  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. In der Liste neben der Eigenschaft TypeName, wählen Sie den entsprechenden Datentyp aus (beispielsweise, Int32).

    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.

    • Für eine Klasse im Projekt, wählen Sie den Pfeil nach unten neben der Eigenschaft TypeName auswählen, die Registerkarte Aktuelles Projekt im Dialogfeld, das angezeigt wird, und wählen Sie dann die 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. Im Fenster BDC-Methodendetails öffnen Sie die Liste, die für den Typdeskriptor angezeigt wird, und wählen Sie dann Bearbeiten aus.

    Das Fenster BDC-Explorer wird geöffnet.

  4. In BDC-Explorer öffnen Sie das Kontextmenü des Typdeskriptors, und wählen Sie dann Typdeskriptor hinzufügen aus.

    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. BDC-Methodendetails wählen Sie im Fenster den Typdeskriptor des Parameters aus, den Sie erstellen möchten.

  2. Wählen Sie auf der Menüleiste die Optionen Ansicht und Eigenschaftenfenster aus.

  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.

    • Für eine Klasse im Projekt, wählen Sie den Pfeil nach unten neben der Eigenschaft TypeName auswählen, die Registerkarte Aktuelles Projekt im Dialogfeld, das angezeigt wird, und wählen Sie dann die 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. Im Fenster BDC-Methodendetails öffnen Sie die Liste, die für den Typdeskriptor angezeigt wird, und wählen Sie dann Bearbeiten aus.

    Das Fenster BDC-Explorer wird geöffnet.

  7. In BDC-Explorer öffnen Sie das Kontextmenü des Typdeskriptors, und wählen Sie dann Typdeskriptor hinzufügen aus.

    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