Gewusst wie: Hinzufügen einer bestimmten Finder-Methode

Sie können eine einzelne Entitätsinstanz zurückgeben, indem Sie eine spezifische Finder-Methode erstellen.Der Dienst (Business Data Connectivity) führt die spezifische Finder-Methode aus, wenn ein Benutzer eine Entität in einem Geschäftsdatenwebpart oder einer externen Liste auswählt.Weitere Informationen finden Sie unter Entwerfen eines Business Data Connectivity-Modells.

So erstellen Sie eine spezifische Finder-Methode

1. Wählen Sie im BDC-Designer eine Entität aus.

   Informationen darüber, wie eine Entität im BDC-Designer in Visual Studio, finden Sie unter Gewusst wie: Hinzufügen einer Entität zu einem Modell hinzugefügt wird.

2. Klicken Sie auf der Menüleiste wählen Sie Ansicht, Weitere Fenster, BDC-Methodendetails aus.

   Das Fenster BDC-Methodendetails wird geöffnet.Weitere Informationen über dieses Fenster, finden Sie unter Übersicht über Entwurfstools für BDC-Modelle.

3. In der Liste wählen Sie Methode hinzufügenSpezifische Finder-Methode erstellen aus.

   Mit Visual Studio werden dem Modell die folgenden Elemente hinzugefügt.Diese Elemente werden im Fenster BDC-Methodendetails angezeigt.

   • Eine Methode.

   • Ein Eingabeparameter für die Methode.

   • Ein Rückgabeparameter für die Methode.

   • Ein Typdeskriptor für jeden Parameter.

   • Eine Methodeninstanz für die Methode.

   Weitere Informationen finden Sie unter Entwerfen eines Business Data Connectivity-Modells.

4. Öffnen Sie das Fenster Eigenschaften von Visual Studio.

5. Konfigurieren Sie den Typdeskriptor des Rückgabeparameters als Entitätstypdeskriptor.Informationen dazu, wie Sie einen Entitätstypdeskriptor, finden Sie unter Gewusst wie: Definieren des Typdeskriptors für einen Parameter erstellt.

   Hinweis
   Sie müssen diesen Schritt nicht ausführen, wenn Sie der Entität eine Finder-Methode hinzugefügt haben.Visual Studio verwendet den Typdeskriptor, den Sie in der Finder-Methode definiert haben.

   Hinweis
   Wenn das Bezeichnerfeld des Entitätstyps ein Feld in einer Datenbanktabelle darstellt, die automatisch generiert wird, legen Sie die Eigenschaft Schreibgeschützt des Bezeichnerfelds auf True fest.

6. Im Fenster Methodendetails wählen Sie die Methodeninstanz der Methode aus.

7. Legen Sie im Eigenschaftenfenster die Eigenschaft Rückgabeparametername auf den Namen des Rückgabeparameters der Methode fest.Weitere Informationen zu Methodeninstanzeigenschaften finden Sie im Thema zu MethodInstance (möglicherweise in englischer Sprache).

8. In Projektmappen-Explorer öffnen Sie das Kontextmenü der Dienstcodedatei, die für die Entität generiert wurde, und wählen Sie dann Code anzeigen aus.

   Die Codedatei für den Entitätsdienst wird im Code-Editor geöffnet.Weitere Informationen zur Codedatei für den Entitätsdienst finden Sie unter Erstellen eines Business Data Connectivity-Modells.

9. Fügen Sie der spezifischen Finder-Methode Code hinzu.Mit diesem Code werden die folgenden Aufgaben ausgeführt:

   • Ruft einen Datensatz aus einer Datenquelle.

   • Gibt eine Entität an den BDC-Dienst.

   Im folgenden Beispiel wird ein Kontakt aus der AdventureWorks-Beispieldatenbank für SQL Server zurückgegeben.

   Hinweis
   Ersetzen Sie den Wert des Felds ServerName durch den Namen Ihres Servers.

   Public Shared Function ReadItem(ByVal contactID As Integer) As Contact
       Const ServerName As String = "MySQLServerName"
       Dim dataContext As AdventureWorksDataContext = _
           New AdventureWorksDataContext("Data Source=" & ServerName & _
               ";Initial Catalog=AdventureWorks;Integrated Security=True")
   
       Dim Contact As Contact = _
           (From TempContacts In dataContext.Contacts.AsEnumerable().Take(20) _
           Where TempContacts.ContactID = contactID _
           Select TempContacts).[Single]()
       Return Contact
   End Function
   

   public static Contact ReadItem(int contactID)
   {
       const string ServerName = "MySQLServerName";
       AdventureWorksDataContext dataContext = new AdventureWorksDataContext
             ("Data Source=" + ServerName + ";" +
              "Initial Catalog=AdventureWorks;Integrated Security=True");
   
       Contact Contact =
           (from contacts in dataContext.Contacts.AsEnumerable().Take(20)
            where contacts.ContactID == contactID
            select contacts).Single();
       return Contact;
   }
   

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen einer Finder-Methode

Gewusst wie: Hinzufügen einer Creator-Methode

Gewusst wie: Hinzufügen einer Deleter-Methode

Gewusst wie: Hinzufügen einer Updater-Methode

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