Partager via

Procédure : créer un nouvel modèle EDM (Entity Data Model)

  • Article

Cette rubrique explique comment créer un nouveau modèle EDM (Entity Data Model) à l'aide de l'Assistant EDM. Les procédures de cette rubrique expliquent comment générer un modèle qui est basé sur une base de données existante (recommandé pour cette version d'ADO.NET Entity Data Model Designer), et comment générer un modèle vide.

NoteRemarque

Vous générez généralement un modèle vide lorsque vous voulez modeler les données d'une application avant de concevoir le schéma de stockage. La modélisation préalable des données requiert le déploiement de l'application avec une source de données qui s'ajuste au modèle.

Un modèle EDM peut être inclus dans les catégories de projet Visual Studio suivantes :

  • Projets d'application

  • Bibliothèques de classes

  • Projets Web

Il est possible d'ajouter plusieurs modèles EDM au même projet, et chaque modèle EDM 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 modèle EDM à partir d'une base de données existante

  1. Ouvrez ou créez le projet pour lequel vous voulez créer un modèle EDM.

  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 modèle (<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.

    NoteRemarque

    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.

  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 modèle EDM.

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

    NoteRemarque

    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.

  10. Cliquez sur Terminer pour créer le modèle EDM.

    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.

    NoteRemarque

    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 Personnalisation des objets (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 EDM 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 des outils Entity Data Model et Scénarios ADO.NET Entity Data Model Designer.

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

Pour créer un modèle vide

  1. Ouvrez ou créez le projet pour lequel vous voulez créer un modèle EDM.

  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 modèle (<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.

    NoteRemarque

    Le fichier .edmx généré ne contient pas d'informations de stockage, conceptuelles ou de mappage. Pour plus d'informations sur l'ajout à votre modèle en modifiant ce fichier, voir Entity Data Model, Spécifications EDM et Schémas et spécification de mappage (Entity Framework).
    • 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.
    NoteRemarque

    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é.

Voir aussi

Concepts

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

Autres ressources

Tâches des outils Entity Data Model