Gewusst wie: Hinzufügen einer Finder-Methode

Aktivieren den Business Data Connectivity Service, um eine Liste der Entitäten in einem Webpart oder einer Liste anzuzeigen, müssen Sie erstellen eine Finder Methode.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 eine Entität im BDC-Designer.

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

2. Wählen Sie auf der Menüleiste Anzeigen, Weitere Fenster, BDC Methodendetails.

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

3. In der eine Methode hinzufügen Liste, wählen Sie Suchmethode erstellen.

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

4. Konfigurieren Sie den Typdeskriptor als Entitätsauflistungs-Typdeskriptor.Weitere Informationen zum Erstellen eines Entitätsauflistungs-Typdeskriptors finden Sie unter Gewusst wie: Definieren des Typdeskriptors für einen Parameter.

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

5. In Projektmappen-Explorer, öffnen Sie das Kontextmenü für den Dienst Code-Datei, die generiert wurde für die Entität, und wählen Sie dann Code anzeigen.Weitere Informationen zur Dienstcodedatei 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 ausgeführt:

   • Ruft Daten aus einer Datenquelle ab.

   • Gibt eine Liste der Entitäten mit dem BDC-Dienst zurück.

   Im folgenden Beispiel wird eine Auflistung von Contact-Entitäten unter Verwendung 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.

   Public Shared Function ReadList() As IEnumerable(Of Contact)
       Const ServerName As String = "MySQLServerName"
       Dim dataContext As AdventureWorksDataContext = _
           New AdventureWorksDataContext("Data Source=" & ServerName & _
               ";Initial Catalog=AdventureWorks;Integrated Security=True")
   
       Dim Contacts As IEnumerable(Of Contact) = _
           From TempContacts In dataContext.Contacts.Take(20) _
                 Select TempContacts
       Return Contacts
   End Function
   

   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;
   
   }
   

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen einer bestimmten 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