Hinzufügen einer Finder-Methode

Damit der Business Data Connectivity (BDC)-Dienst eine Liste von Entitäten in einem Webpart oder einer Liste anzeigen kann, müssen Sie eine Finder-Methode erstellen. Eine Finder-Methode ist eine spezielle Methode, die eine Auflistung von Entitätsinstanzen zurückgibt. Weitere Informationen finden Sie unter Entwerfen eines Business Data Connectivity-Modells.

So erstellen Sie eine Finder-Methode

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

   Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen einer Entität zu einem Modell.

2. Wählen Sie in der MenüleisteAnsicht>Weitere Fenster>BDC-Methodendetails aus.

   Das Fenster BDC-Methodendetails wird geöffnet. Weitere Informationen zum Fenster BDC-Methodendetails finden Sie in der Übersicht der Entwurfstools für BDC-Modelle.

3. Wählen Sie in der Liste Methode hinzufügen die Option Finder-Methode erstellen aus.

   Visual Studio fügt eine Methode, einen Rückgabeparameter und einen Typdeskriptor hinzu.

4. Konfigurieren Sie den Typdeskriptor als Entitätssammlungstypdeskriptor. Weitere Informationen zum Erstellen eines Entitätssammlungstypdeskriptors finden Sie unter Gewusst wie: Definieren des Typdeskriptors eines Parameters.

   Hinweis

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

5. Öffnen Sie im Projektmappen-Explorer das Kontextmenü der Dienstcodedatei, die für die Entität generiert wurde, und wählen Sie dann Code anzeigen aus. Weitere Informationen zur Codedatei des Diensts finden Sie unter Erstellen eines Business Data Connectivity-Modells.

6. Fügen Sie der Finder-Methode Code hinzu. Mit diesem Code werden die folgenden Aufgaben durchgeführt:

   • Ruft Daten aus einer Datenquelle ab.

   • Gibt eine Liste von Entitäten an den BDC-Dienst zurück.

     Im folgenden Beispiel wird eine Auflistung von Contact-Entitäten mithilfe von Daten aus der AdventureWorks-Beispieldatenbank für SQL Server zurückgegeben.

   Hinweis

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

   • C#
   • VB

   public static IEnumerable<Contact> ReadList()
   {
       const string ServerName = "MySQLServerName";
       AdventureWorksDataContext dataContext = new AdventureWorksDataContext
             ("Data Source=" + ServerName + ";" +
              "Initial Catalog=AdventureWorks;Integrated Security=True");
   
       IEnumerable<Contact> Contacts =
           from contacts in dataContext.Contacts.Take(20)
           select contacts;
       return Contacts;
   
   }
   

Zugehöriger Inhalt

• Übersicht über Entwurfstools für BDC-Modelle
• Entwerfen eines Business Data Connectivity-Modells
• Gewusst wie: Hinzufügen einer spezifischen Finder-Methode
• Gewusst wie: Hinzufügen einer Creator-Methode
• Vorgehensweise: Hinzufügen einer Deleter-Methode
• Gewusst wie: Hinzufügen einer Updater-Methode
• Gewusst wie: Hinzufügen eines Parameters zu einer Methode
• Definieren einer Methodeninstanz