Procédure : créer un fichier .edmx (Entity Data Model Tools)

Cette rubrique décrit la façon de créer un nouveau fichier .edmx à l'aide de l'Assistant EDM. Un fichier .edmx contient le modèle conceptuel, ainsi qu'un modèle de stockage et les mappages entre eux. Les procédures dans cette rubrique décrivent comment générer un fichier .edmx à partir d'une base de données existante et comment générer un fichier .edmx vide.

Remarque :

Après avoir généré un fichier .edmx vide, vous pouvez utiliser ADO.NET Entity Data Model Designer (Concepteur d'entités) pour créer des entités et des relations.Vous pouvez utiliser ensuite l'Assistant Création d'une base de données pour générer une base de données à partir du fichier .edmx.Pour plus d'informations, consultez Procédure : générer une base de données à partir d'un modèle conceptuel (Entity Data Model Tools).

Pour plus d'informations sur les fichiers .edmx, consultez Présentation d'un fichier .edmx (Entity Framework). Un fichier .edmx peut être inclus dans les catégories de projet Visual Studio suivantes :

• Projets d'application

• Bibliothèques de classes

• Projets Web

Plusieurs fichiers .edmx peuvent être ajoutés au même projet, et chaque fichier peut cibler une base de données différente, une table différente de la même base de données, ou les deux.

Pour créer un fichier .edmx à partir d'une base de données existante

1. Ouvrez ou créez le projet pour lequel vous voulez créer un fichier .edmx.

2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, pointez sur Ajouter, puis cliquez sur Nouvel élément.

3. Sélectionnez ADO.NET Entity Data Model dans le volet Modèles.

4. Entrez le nom du fichier (<nom_projet>.edmx), puis cliquez sur Ajouter.

   La première page de l'Assistant EDM s'affiche.

5. Sélectionnez Générer à partir de la base de données dans la boîte de dialogue Choisir le contenu du Model, puis cliquez sur Suivant.

6. Cliquez sur le bouton Nouvelle connexion.

   La boîte de dialogue Propriétés de connexion s'affiche.

7. Entrez le nom du serveur, sélectionnez la méthode d'authentification, puis entrez le nom de la base de données pour laquelle le modèle est créé. Cliquez sur OK.

   La boîte de dialogue Choisir votre connexion de données est mise à jour avec les paramètres de connexion à la base de données.

   Remarque :

   Par défaut, les paramètres de connexion d'entité sont enregistrés dans le fichier App.config ou Web.config (en fonction du type de projet).Tapez un nom pour la connexion ou utilisez celui fourni par défaut.Désactivez la case à cocher Enregistrer les paramètres de connexion du entity si vous ne voulez pas que les informations de connexion soient enregistrées dans un fichier de configuration.Pour plus d'informations sur l'enregistrement des paramètres de connexion, voir Boîte de dialogue Choisir votre connexion de données (Assistant EDM).

8. Cliquez sur Suivant pour continuer.

   La boîte de dialogue Choisir vos objets de base de données s'affiche. Par défaut, aucun objet de la base de données n'est sélectionné pour être inclus dans le fichier .edmx.

9. Développez les nœuds des tables, des vues et des procédures stockées. Annulez la sélection des tables, des vues et des procédures stockées que vous ne voulez pas inclure dans le fichier .edmx.

   Remarque :
   Les classes générées à partir du modèle conceptuel seront dans l'Espace de noms de Model.Tapez un nom pour l'espace de noms ou utilisez celui fourni par défaut.Pour plus d'informations, consultez Présentation du code généré (Entity Data Model Designer).

10. Cliquez sur Terminer pour créer le fichier .edmx.

    L'Assistant EDM effectue les opérations suivantes :

    • Il ajoute au projet des références aux assemblys System.Data, System.Data.Entity, System.Core, System.Security et System.Runtime.Serialization, si elles n'existent pas déjà.

    • Il génère un fichier .edmx qui encapsule le modèle de stockage, le modèle conceptuel et des mappages.

    • Il crée un fichier de code source qui contient les classes générées à partir du modèle conceptuel. Vous pouvez afficher le fichier de code source en développant le nœud .edmx dans l'Explorateur de solutions. Pour afficher le fichier de code source dans des projets Visual Basic, vous devez cliquer sur le bouton Afficher tous les fichiers de l'Explorateur de solutions avant de développer le nœud .edmx.

    Remarque :

    Le fichier de code source est généré à partir du fichier .edmx.Toutes les modifications manuelles apportées au fichier de code source sont remplacées lorsque le fichier .edmx correspondant est modifié.Pour empêcher que le code personnalisé soit remplacé, vous pouvez écrire des classes partielles qui sont stockées dans des fichiers séparés.Pour plus d'informations, voir Customizing Objects (Entity Framework).

    • Il crée un fichier App.Config ou Web.Config (en fonction du type de projet).

    • Pour les projets de site Web ASP.NET, il définit un fournisseur de générations dans le fichier Web.config.

    • Il affiche le modèle conceptuel dans ADO.NET Entity Data Model Designer (Concepteur d'entités). Pour plus d'informations sur la modification de votre modèle à l'aide du Concepteur d'entités, voir Tâches Entity Data Model Tools et Scénarios Entity Data Model Tools.

Pour obtenir un exemple de création d'un modèle réel à partir d'une base de données existante, consultez Quickstart (Entity Framework).

Pour créer un fichier .edmx vide

1. Ouvrez ou créez le projet pour lequel vous voulez créer un fichier .edmx.

2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, pointez sur Ajouter, puis cliquez sur Nouvel élément.

3. Sélectionnez ADO.NET Entity Data Model dans le volet Modèles.

4. Entrez le nom du fichier (<nom_projet>.edmx), puis cliquez sur Ajouter.

   La première page de l'Assistant EDM s'affiche.

5. Sélectionnez Modèle vide dans la boîte de dialogue Choisir le contenu du Model, puis cliquez sur Terminer.

   L'Assistant EDM effectue les opérations suivantes :

   • Il ajoute au projet des références aux assemblys System.Data, System.Data.Entity, System.Core, System.Security et System.Runtime.Serialization, si elles n'existent pas déjà.

   • Il génère un fichier .edmx permettant d'encapsuler le modèle de stockage, le modèle conceptuel et des mappages.

   Remarque :

   Le fichier .edmx généré ne contient pas d'informations de stockage, conceptuelles ou de mappage.Pour plus d'informations sur la façon de modifier ce fichier de configuration manuellement, consultez Mapping Schemas and Storage Metadata (EDM).Pour plus d'informations sur la génération d'une base de données à partir d'un modèle conceptuel, consultez Assistant Génération de la base de données (Entity Data Model Tools) et Procédure : générer une base de données à partir d'un modèle conceptuel (Entity Data Model Tools).

   • Il crée un fichier de code source vide destiné à contenir les classes qui sont générées à partir du modèle conceptuel. Vous pouvez afficher le fichier de code source en développant le nœud .edmx dans l'Explorateur de solutions. Pour afficher le fichier de code source dans des projets Visual Basic, vous devez cliquer sur le bouton Afficher tous les fichiers de l'Explorateur de solutions avant de développer le nœud .edmx.

   Remarque :
   Le fichier de code source est généré à partir du fichier .edmx.Toutes les modifications manuelles apportées au fichier de code source sont remplacées lorsque le fichier .edmx correspondant est modifié.

   • Il crée un fichier App.Config ou Web.Config (en fonction du type de projet).

   • Il démarre le Concepteur d'entités, lequel fournit une aire de conception permettant de modifier votre modèle. Pour plus d'informations sur la création de votre modèle à l'aide du Concepteur d'entités, voir Tâches Entity Data Model Tools et Scénarios Entity Data Model Tools.

Voir aussi

Concepts

Création d'une application à l'aide d'un modèle conceptuel (Entity Data Model Tools)

Autres ressources

Tâches Entity Data Model Tools