Gewusst wie: Importieren einer gespeicherten Prozedur (Entity Data Model-Tools)

In diesem Thema wird beschrieben, wie gespeicherte Prozeduren mit dem ADO.NET Entity Data Model Designer (Entity Designer) importiert werden.

Eine dem konzeptionellen Modell hinzugefügte gespeicherte Prozedur wird als Funktionsimport bezeichnet. Das Hinzufügen eines Funktionsimports ermöglicht es Ihnen, die entsprechende gespeicherte Prozedur vom Anwendungscode aus aufzurufen. Ein Funktionsimport kann Auflistungen von einfachen Typen, EntityTypes oder ComplexTypes oder keinen Wert zurückgeben.

Hinweis:
Gespeicherten Prozeduren können Insert-, Update- und Delete-Vorgänge eines Entitätstyps zugeordnet werden.Weitere Informationen finden Sie unter Gewusst wie: Zuordnen von Änderungsfunktionen zu gespeicherten Prozeduren (Entity Data Model-Tools).

Wenn der Assistent für Entity Data Model eine EDMX-Datei aus einer Datenbank generiert, werden für jede gespeicherte Prozedur in der Datenbank Einträge im Speichermodell erstellt. Dem konzeptionellen Modell werden beim Erstellen von Funktionsimporten entsprechende Einträge hinzugefügt.

Im folgenden Verfahren wird das Erstellen eines Funktionsimports beschrieben. Informationen zum Aufrufen eines Funktionsimports im Anwendungscode finden Sie unter How to Execute a Query Using a Stored Procedure und Exemplarische Vorgehensweise: Abrufen von Entitätstypen mit einer gespeicherten Prozedur (Entity Data Model-Tools).

So erstellen Sie einen Funktionsimport

1. Führen Sie im Modellbrowser einen der folgenden Schritte aus:

   • Öffnen Sie den Ordner Gespeicherte Prozeduren (in den Informationen zum Speichermodell), und doppelklicken Sie auf eine gespeicherte Prozedur, die nicht über einen entsprechenden Funktionsimport verfügt.

   - ODER -

   • Klicken Sie mit der rechten Maustaste auf den Ordner Funktionsimporte (im EntityContainer-Knoten der Informationen zum konzeptionellen Modell), und wählen Sie dann Funktionsimport hinzufügen aus.

   Das Dialogfeld Funktionsimport hinzufügen wird angezeigt.

2. Geben Sie die Einstellungen für den neuen Funktionsimport ein.

   • Geben Sie im Feld Name der gespeicherten Prozedur die gespeicherte Prozedur an, für die Sie einen Funktionsimport erstellen. Dieses Feld wird als Dropdownliste angezeigt, die alle gespeicherten Prozeduren im Speichermodell enthält. Falls die gewünschte gespeicherte Prozedur nicht verfügbar ist, müssen Sie das Speichermodell möglicherweise aktualisieren. Weitere Informationen finden Sie unter Gewusst wie: Aktualisieren einer EDMX-Datei bei einer Änderung der Datenbank (Entity Data Model-Tools).

   • Geben Sie den Namen des Funktionsimports im Feld Name des Funktionsimports an.

   • Geben Sie einen der vier grundlegenden Rückgabetypen an: Keine, Skalare, Komplex oder Entitäten, und wählen Sie den spezifischen Rückgabetyp in der Dropdownliste aus. Bei Auswahl von Komplex kann der Entity Designer einen neuen komplexen Typ mit Eigenschaften erstellen, die den von der gespeicherten Prozedur zurückgegebenen Spalten entsprechen.

   1. Klicken Sie auf Spalteninformationen abrufen, um Spalteninformationen abzurufen.

   2. Klicken Sie auf Neuen komplexen Typ erstellen.

   3. Bearbeiten Sie den Namen des komplexen Typs in der Dropdownliste Komplex.

      Wenn Sie auf OK klicken, wird dem konzeptionellen Modell ein neuer komplexer Typ hinzugefügt, und der Rückgabetyp des Funktionsimports wird auf diesen neuen Typ festgelegt.

      Hinweis:
      Wenn Sie die Definition für die gespeicherte Prozedur im Speichermodell geändert haben, können Sie den zurückgegebenen komplexen Typ automatisch aktualisieren, indem Sie auf Aktualisieren klicken.

   Hinweis:
   Falls die Anwendung .NET Framework 3.5 SP1 als Ziel hat, werden komplexe Typen nicht als Rückgabetyp für Funktionsimporte unterstützt.

3. Klicken Sie auf OK.

   Der FunctionImport-Eintrag wird im konzeptionellen Modell erstellt. Weitere Informationen finden Sie unter FunctionImport Element (CSDL).

Siehe auch

Konzepte

ADO.NET Entity Data Model-Designer

Weitere Ressourcen

Aufgaben der Entity Data Model-Tools