Procédure : importer une procédure stockée (Entity Data Model Tools)

Cette rubrique décrit comment importer une procédure stockée à l'aide d'ADO.NET Entity Data Model Designer (Entity Designer).

Lorsqu'une procédure stockée est ajoutée à un modèle conceptuel, elle est appelée importation de fonction. L'ajout d'une importation de fonction vous permet d'appeler la procédure stockée correspondante à partir de votre code d'application. Une importation de fonction peut retourner des collections de types simples, d'EntityTypes ou de ComplexTypes, ou aucune valeur.

Remarque :
Les opérations d'insertion, de mise à jour et de suppression d'un type d'entité peuvent être mappées à des procédures stockées.Pour plus d'informations, consultez Procédure : mapper des fonctions de modification à des procédures stockées (Entity Data Model Tools).

Lorsque l'Assistant EDM génère un fichier .edmx à partir d'une base de données, il crée des entrées dans le modèle de stockage pour chaque procédure stockée de la base de données. Les entrées correspondantes sont ajoutées au modèle conceptuel lorsque des importations de fonction sont créées.

La procédure suivante décrit comment créer une importation de fonction. Pour plus d'informations sur l'appel d'une importation de fonction à partir du code d'application, consultez How to Execute a Query Using a Stored Procedure et Procédure pas à pas : récupération de types d'entité avec une procédure stockée (Entity Data Model Tools).

Pour créer une importation de fonction

1. Dans l'Explorateur de modèles, effectuez l'une des opérations suivantes :

   • Ouvrez le dossier Procédures stockées (dans les informations du modèle de stockage), puis double-cliquez sur une procédure stockée qui n'a pas d'importation de fonction correspondante.

   - OU -

   • Cliquez avec le bouton droit sur le dossier Importations de fonction (dans le nœud EntityContainer des informations du modèle conceptuel), puis sélectionnez Ajouter une importation de fonction.

   La boîte de dialogue Ajouter une importation de fonction s'affiche.

2. Définissez les paramètres de la nouvelle importation de fonction.

   • Spécifiez la procédure stockée pour laquelle vous créez une importation de fonction dans le champ Nom de la procédure stockée. Ce champ est une liste déroulante qui affiche toutes les procédures stockées dans le modèle de stockage. Si la procédure stockée désirée n'est pas disponible, vous devrez peut-être mettre à jour votre modèle de stockage. Pour plus d'informations, consultez Procédure : mettre à jour un fichier .edmx lorsque la base de données change (Entity Data Model Tools).

   • Spécifiez le nom de l'importation de fonction dans le champ Nom de l'importation de fonction.

   • Spécifiez l'un des quatre types de retour de base : Aucun, Scalaires, Complexe ou Entités, puis sélectionnez le type de retour spécifique dans la liste déroulante disponible. Si vous choisissez Complexe, le Concepteur d'entités peut créer un type complexe avec des propriétés qui correspondent aux colonnes retournées par la procédure stockée.

   1. Cliquez sur Obtenir les informations de colonne pour récupérer les informations de colonne.

   2. Cliquez sur Créer un type complexe.

   3. Modifiez le nom du type complexe dans la liste déroulante Complexe.

      Lorsque vous cliquez sur OK, un nouveau type complexe est ajouté au modèle conceptuel et ce nouveau type est affecté au type de retour de l'importation de fonction.

      Remarque :
      Si vous avez modifié la définition de votre procédure stockée dans le modèle de stockage, vous pouvez mettre à jour automatiquement le type complexe retourné en cliquant sur Mettre à jour.

   Remarque :
   Si votre application cible le .NET Framework 3.5 SP1, les types complexes ne sont pas pris en charge comme type de retour pour les importations de fonction.

3. Cliquez sur OK.

   L'entrée FunctionImport est créée dans le modèle conceptuel. Pour plus d'informations, consultez FunctionImport Element (CSDL).

Voir aussi

Concepts

ADO.NET Entity Data Model Designer

Autres ressources

Tâches Entity Data Model Tools