EDM Generator (EdmGen.exe)
EdmGen.exe est un outil en ligne de commande utilisé avec le modèle Entity Framework et les fichiers de mappage. Vous pouvez utiliser l'outil EdmGen.exe pour effectuer les opérations suivantes :
Vous connecter à une source de données en utilisant un fournisseur de données .NET Framework spécifique à la source de données, et générer les fichiers de modèle conceptuel (.csdl), de modèle de stockage (.ssdl) et de mappage (.msl) utilisés par Entity Framework. Pour plus d’informations, consultez Procédure : Utiliser EdmGen.exe pour générer des fichiers de modèle et des fichiers de mappage.
Valider un modèle existant. Pour plus d’informations, consultez Procédure : Utiliser EdmGen.exe pour valider les fichiers de modèle et les fichiers de mappage.
Générer un fichier de code C# ou Visual Basic qui contient les classes d'objets générées à partir d'un fichier de modèle conceptuel (.csdl). Pour plus d’informations, consultez Procédure : Utiliser EdmGen.exe pour générer le code de couche objet.
Générez un fichier de code C# ou Visual Basic qui contient les vues prégénérées d'un modèle existant. Pour plus d’informations, consultez Procédure : Prégénérer les vues pour améliorer les performances des requêtes.
L’outil EdmGen.exe est installé dans le répertoire du .NET Framework. Dans de nombreux cas, celui-ci se trouve dans C:\windows\Microsoft.NET\Framework\v4.0. Pour les systèmes 64 bits, il se trouve dans C:\windows\Microsoft.NET\Framework64\v4.0. Vous pouvez également accéder à l’outil EdmGen.exe à partir de l’invite de commandes de Microsoft Visual Studio (cliquez sur Démarrer, pointez sur Tous les programmes, sur Microsoft Visual Studio 2010 et sur Visual Studio Tools, puis cliquez sur Invite de commandes de Visual Studio 2010).
Syntaxe
EdmGen /mode:choice [options]
Mode
Lorsque vous utilisez l'outil EdmGen.exe, vous devez spécifier l'un des modes suivants.
| Mode | Description |
|---|---|
/mode:ValidateArtifacts |
Valide les fichiers .csdl, .ssdl et .msl, et affiche les erreurs ou les avertissements éventuels. Cette option requiert au moins l'un des arguments /inssdl ou /incsdl. Si /inmsl est spécifié, les arguments /inssdl et /incsdl sont également requis. |
/mode:FullGeneration |
Utilise les informations de connexion à la base de données spécifiées dans l'option /connectionstring et génère des fichiers .csdl, .ssdl, .msl, de couche objet et de vue.Cette option requiert un argument /connectionstring, et soit un argument /project soit les arguments /outssdl, /outcsdl, /outmsdl, /outobjectlayer, /outviews, /namespace et /entitycontainer. |
/mode:FromSSDLGeneration |
Génère des fichiers .csdl et .msl, du code source et des vues à partir du fichier .ssdl spécifié. Cette option requiert l’argument /inssdl, et soit un argument /project soit les arguments /outcsdl, /outmsl, /outobjectlayer, /outviews, /namespace, et /entitycontainer. |
/mode:EntityClassGeneration |
Crée un fichier de code source qui contient les classes générées à partir du fichier .csdl. Cette option requiert l’argument /incsdl, et soit l’argument /project soit l’argument /outobjectlayer. L'argument /language est obligatoire. |
/mode:ViewGeneration |
Crée un fichier de code source qui contient les vues générées à partir des fichiers .csdl, .ssdl, et .msl. Cette option requiert les arguments /inssdl, /incsdl, /inmsl, et soit l’argument /project soit l’argument /outviews. L'argument /language est obligatoire. |
Options
| Option | Description |
|---|---|
/p[roject]:<chaîne> |
Spécifie le nom de projet à utiliser. Le nom de projet est utilisé comme valeur par défaut pour le paramètre d'espace de noms, le nom du modèle et des fichiers de mappage, le nom du fichier source de l'objet et le nom de fichier source de génération de vues. Le nom du conteneur d’entités a la valeur <projet>Context. |
/prov[ider]:<chaîne> |
Nom du fournisseur de données .NET Framework à utiliser pour générer le fichier de modèle de stockage (.ssdl). Le fournisseur par défaut est le fournisseur de données .NET Framework pour SQL Server (System.Data.SqlClient). |
/c[onnectionstring]:<chaîne de connexion> |
Spécifie la chaîne utilisée pour se connecter à la source de données. |
/incsdl:<file> |
Spécifie le fichier .csdl ou un répertoire où se trouvent les fichiers .csdl. Cet argument peut être spécifié plusieurs fois afin de pouvoir spécifier plusieurs répertoires ou fichiers .csdl. La spécification de plusieurs répertoires peut être utile pour générer des classes (/mode:EntityClassGeneration) ou des vues (/mode:ViewGeneration) lorsque le modèle conceptuel est divisé en plusieurs fichiers. Cela peut également être utile lorsque vous voulez valider plusieurs modèles (/mode:ValidateArtifacts). |
/refcsdl:<file> |
Spécifie le ou les fichiers .csdl supplémentaires utilisés pour résoudre toute référence dans le fichier .csdl source. (Le fichier .csdl source est le fichier spécifié par l'option /incsdl). Le fichier /refcsdl contient des types dont dépend le fichier .csdl source. Cet argument peut être spécifié plusieurs fois. |
/inmsl:<file> |
Spécifie le fichier .msl ou un répertoire où se trouvent les fichiers .msl. Cet argument peut être spécifié plusieurs fois afin de pouvoir spécifier plusieurs répertoires ou fichiers .msl. La spécification de plusieurs répertoires peut être utile pour générer des vues (/mode:ViewGeneration) lorsque le modèle conceptuel est divisé en plusieurs fichiers. Cela peut également être utile lorsque vous voulez valider plusieurs modèles (/mode:ValidateArtifacts). |
/inssdl:<file> |
Spécifie le fichier .ssdl ou un répertoire où se trouvent les fichiers .ssdl. Cet argument peut être spécifié plusieurs fois afin de pouvoir spécifier plusieurs répertoires ou fichiers .ssdl. Cela peut être utile lorsque vous voulez valider plusieurs modèles (/mode:ValidateArtifacts). |
/outcsdl:<file> |
Spécifie le nom du fichier .csdl qui sera créé. |
/outmsl:<file> |
Spécifie le nom du fichier .msl qui sera créé. |
/outssdl:<file> |
Spécifie le nom du fichier .ssdl qui sera créé. |
/outobjectlayer:<file> |
Spécifie le nom du fichier de code source qui contient les objets générés à partir du fichier .csdl. |
/outviews:<file> |
Spécifie le nom du fichier de code source qui contient les vues qui ont été générés. |
/language:[VB|CSharp] |
Spécifie le langage des fichiers de code source générés. Le langage par défaut est C#. |
/namespace:<chaîne> |
Spécifie l'espace de noms du modèle à utiliser. L'espace de noms est défini dans le fichier .csdl lors de l'exécution de /mode:FullGeneration ou de /mode:FromSSDLGeneration. L'espace de noms n'est pas utilisé lors de l'exécution de /mode:EntityClassGeneration. |
/entitycontainer:<chaîne> |
Spécifie le nom à appliquer à l'élément <EntityContainer> dans le modèle et les fichiers de mappage générés. |
/pl[uralize] |
Applique aux noms Entity, EntitySet et NavigationProperty dans le modèle conceptuel les règles de la langue anglaise pour les singuliers et les pluriels. Cette option effectuera les actions suivantes :- Mettre tous les noms EntityType au singulier.- Mettre tous les noms EntitySet au pluriel.- Pour chaque NavigationProperty qui retourne une entité au plus, mettre le nom au singulier.- Pour chaque NavigationProperty qui retourne plusieurs entités, mettre le nom au pluriel. |
/SuppressForeignKeyProperties or /nofk |
Empêche que des colonnes de clé étrangère soient exposées comme propriétés scalaires sur les types d'entité dans le modèle conceptuel. |
/help ou ? |
Affiche la syntaxe et les options de commande de l'outil. |
/nologo |
Supprime l'affichage du message de copyright. |
/targetversion:<chaîne> |
Version du .NET Framework qui sera utilisée pour compiler le code généré. Les versions prises en charge sont 4 et 4.5. La valeur par défaut est 4. |
Dans cette section
Procédure : Utiliser EdmGen.exe pour générer des fichiers de modèle et des fichiers de mappage
Procédure : Utiliser EdmGen.exe pour générer le code de couche objet
Procédure : Utiliser EdmGen.exe pour valider les fichiers de modèle et les fichiers de mappage