Gewusst wie: Hinzufügen einer Finder-Methode

  • Artikel

Damit der Business Data Connectivity-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 zum Hinzufügen einer Entität zum BDC-Designer in Visual Studio. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen einer Entität zu einem Modell.

  2. Klicken Sie im Menü Ansicht auf Weitere Fenster und dann auf 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. Wählen Sie im Fenster BDC-Methodendetails in der Dropdownliste Methode hinzufügen den Eintrag Finder-Methode erstellen aus.

    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.

    Tipp

    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. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Dienstcodedatei, die für die Entität generiert wurde, und klicken Sie dann auf 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:

    • Abrufen von Daten aus einer Datenquelle.

    • Zurückgeben einer Liste von Entitäten an den BDC-Dienst.

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

    Tipp

    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