Freigeben über

Hinzufügen einer bestimmten Finder-Methode

Sie können eine einzelne Entitätsinstanz zurückgeben, indem Sie eine Spezifische Finder-Methode erstellen. Der BDC-Dienst (Business Data Connectivity) führt die spezifische Finder-Methode aus, wenn ein Benutzer eine Entität in einem Geschäftsdaten-Webpart oder in 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 zum Hinzufügen einer Entität zum BDC-Designer in Visual Studio finden Sie unter Gewusst wie: 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 zu dem Fenster finden Sie unter Übersicht über Entwurfstools für BDC-Modelle.

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

    Visual Studio fügt dem Modell die folgenden Elemente hinzu. 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 zum Erstellen eines Entitätstypdeskriptors 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 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, das automatisch generiert wird, legen Sie die Read-only-Eigenschaft (schreibgeschützt) des Bezeichnerfelds auf True fest.

  6. Wählen Sie im Fenster Methodendetails die Methodeninstanz der Methode aus.

  7. Legen Sie im Eigenschaftenfenster die Return Parameter Name-Eigenschaft (Rückgabeparametername) auf den Namen des Rückgabeparameters der Methode fest. Weitere Informationen zu Methodeninstanzeigenschaften finden Sie unter MethodInstance.

  8. Ö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.

    Die Codedatei für den Entity-Dienst wird im Code-Editor geöffnet. Weitere Informationen zur Codedatei des Entity-Diensts 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 durchgeführt:

    • Abrufen eines Datensatzes aus einer Datenquelle.

    • Zurückgeben einer 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 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;
}

Zugehöriger Inhalt

  • Last updated on