EDM Generator (EdmGen.exe)
EdmGen.exe je nástroj příkazového řádku, který slouží k práci s modelem Entity Framework a soubory mapování. Pomocí nástroje EdmGen.exe můžete provést následující akce:
Připojte se ke zdroji dat pomocí zprostředkovatele dat specifického pro daný zdroj dat rozhraní .NET Framework a vygenerujte koncepční model (.csdl), model úložiště (.ssdl) a soubory mapování (.msl), které používají Entity Framework. Další informace najdete v tématu Postupy: Použití EdmGen.exe k vygenerování modelu a souborů mapování.
Ověřte existující model. Další informace najdete v tématu Postupy: Použití EdmGen.exe k ověření souborů modelu a mapování.
Vygenerujte soubor kódu jazyka C# nebo Visual Basic, který obsahuje třídy objektů generované ze souboru konceptuálního modelu (.csdl). Další informace naleznete v tématu Postupy: Použití EdmGen.exe k vygenerování kódu vrstvy objektu.
Vygenerujte soubor kódu jazyka C# nebo Visual Basic, který obsahuje předem vygenerovaná zobrazení pro existující model. Další informace: Předběžné generování zobrazení za účelem zlepšení výkonu dotazů.
Nástroj EdmGen.exe je nainstalován v adresáři rozhraní .NET Framework. V mnoha případech se nachází v umístění C:\windows\Microsoft.NET\Framework\v4.0. U 64bitových systémů se nachází v umístění C:\windows\Microsoft.NET\Framework64\v4.0. K nástroji EdmGen.exe můžete přistupovat také z příkazového řádku sady Visual Studio (klepněte na tlačítko Start, přejděte na příkaz Všechny programy, přejděte na položku Microsoft Visual Studio 2010, přejděte na visual Studio Tools a potom klikněte na příkazový řádek sady Visual Studio 2010).
Syntaxe
EdmGen /mode:choice [options]
Režim
Při použití nástroje EdmGen.exe je nutné zadat jeden z následujících režimů.
| Režim | Popis |
|---|---|
/mode:ValidateArtifacts |
Ověří soubory .csdl, .ssdl a .msl a zobrazí případné chyby nebo upozornění. Tato možnost vyžaduje alespoň jeden z /inssdl argumentů./incsdl Pokud /inmsl je zadána, /inssdl /incsdl jsou požadovány i argumenty. |
/mode:FullGeneration |
Používá informace o připojení k databázi zadané v /connectionstring možnosti a generuje soubory .csdl, .ssdl, .msl, vrstva objektu a zobrazit soubory.Tato možnost vyžaduje /connectionstring argument a buď /project argument, nebo /outssdl, /outcsdl, /outmsdl, /outobjectlayer, /outviews, /namespacea /entitycontainer argumenty. |
/mode:FromSSDLGeneration |
Generuje soubory .csdl a .msl, zdrojový kód a zobrazení ze zadaného souboru .ssdl. Tato možnost vyžaduje /inssdl argument a buď /project argument, nebo /outcsdlargument , /outmsl, /outobjectlayer, /outviews, , /namespace, a /entitycontainer argumenty. |
/mode:EntityClassGeneration |
Vytvoří soubor zdrojového kódu, který obsahuje třídy generované ze souboru .csdl. Tato možnost vyžaduje /incsdl argument a /project argument nebo /outobjectlayer argument. Argument /language je nepovinný. |
/mode:ViewGeneration |
Vytvoří soubor zdrojového kódu, který obsahuje zobrazení vygenerovaná ze souborů .csdl, .ssdl a .msl. Tato možnost vyžaduje /inssdl, /incsdl/inmsl, a to buď /project nebo /outviews argumenty. Argument /language je nepovinný. |
Možnosti
| Možnost | Popis |
|---|---|
/p[roject]:<string> |
Určuje název projektu, který se má použít. Název projektu se používá jako výchozí nastavení oboru názvů, název modelu a souborů mapování, název zdrojového souboru objektu a název zdrojového souboru zobrazení. Název kontejneru entity je nastavený na <kontext projektu>. |
/prov[ider]:<string> |
Název zprostředkovatele dat rozhraní .NET Framework, který se má použít k vygenerování souboru modelu úložiště (.ssdl). Výchozí zprostředkovatel je rozhraní .NET Framework Zprostředkovatel dat pro SQL Server (System.Data.SqlClient). |
/c[onnectionstring]:<připojovací řetězec> |
Určuje řetězec, který se používá pro připojení ke zdroji dat. |
/incsdl:<soubor> |
Určuje soubor .csdl nebo adresář, ve kterém jsou umístěné soubory .csdl. Tento argument lze zadat vícekrát, takže můžete zadat několik adresářů nebo souborů .csdl. Určení více adresářů může být užitečné pro generování tříd (/mode:EntityClassGeneration) nebo zobrazení (/mode:ViewGeneration) při rozdělení konceptu modelu mezi několik souborů. To může být užitečné také v případě, že chcete ověřit více modelů (/mode:ValidateArtifacts). |
/refcsdl:<soubor> |
Určuje další soubor .csdl nebo soubory použité k překladu všech odkazů ve zdrojovém souboru .csdl. (Zdrojový soubor .csdl je soubor určený /incsdl možností). Soubor /refcsdl obsahuje typy, na které je zdrojový soubor .csdl závislý. Tento argument lze zadat vícekrát. |
/inmsl:<soubor> |
Určuje soubor .msl nebo adresář, ve kterém jsou umístěny soubory .msl. Tento argument lze zadat vícekrát, takže můžete zadat několik adresářů nebo souborů .msl. Určení více adresářů může být užitečné při generování zobrazení (/mode:ViewGeneration) při rozdělení konceptuálního modelu mezi několik souborů. To může být užitečné také v případě, že chcete ověřit více modelů (/mode:ValidateArtifacts). |
/inssdl:<soubor> |
Určuje soubor .ssdl nebo adresář, kde se nachází soubor .ssdl. Tento argument lze zadat vícekrát, abyste mohli zadat několik adresářů nebo souborů .ssdl. To může být užitečné, pokud chcete ověřit více modelů (/mode:ValidateArtifacts). |
/outcsdl:<soubor> |
Určuje název souboru .csdl, který se vytvoří. |
/outmsl:<soubor> |
Určuje název souboru .msl, který se vytvoří. |
/outssdl:<soubor> |
Určuje název souboru .ssdl, který se vytvoří. |
/outobjectlayer:<soubor> |
Určuje název souboru zdrojového kódu, který obsahuje objekty generované ze souboru .csdl. |
/outviews:<soubor> |
Určuje název souboru zdrojového kódu, který obsahuje vygenerovaná zobrazení. |
/language:[VB|CSharp] |
Určuje jazyk pro vygenerované soubory zdrojového kódu. Výchozí jazyk je jazyk C#. |
/namespace:<string> |
Určuje obor názvů modelu, který se má použít. Obor názvů je nastaven v souboru .csdl při spuštění /mode:FullGeneration nebo /mode:FromSSDLGeneration. Obor názvů se nepoužívá při spuštění /mode:EntityClassGeneration. |
/entitycontainer:<string> |
Určuje název, který se má použít u elementu <EntityContainer> vygenerovaného modelu a souborů mapování. |
/pl[uralize] |
Použije pravidla anglického jazyka pro jednotné číslo a množné číslo na Entity, EntitySeta NavigationProperty názvy v koncepčním modelu. Tato možnost provede následující akce:- Všechna EntityType jména se znamé znaménou znaménou.- Všechna EntitySet jména nastavte v množném čísle.- Pro každou NavigationProperty , která vrací maximálně jednu entitu, zadejte název singulární.– Pro každou NavigationProperty entitu, která vrací více než jednu entitu, zadejte název v množném čísle. |
/SuppressForeignKeyProperties or /nofk |
Zabraňuje zveřejnění sloupců cizího klíče jako skalárních vlastností u typů entit v koncepčním modelu. |
/help nebo ? |
Zobrazí syntaxi příkazu a možnosti nástroje. |
/nologo |
Potlačí zobrazování zprávy o autorských právech. |
/targetversion:<string> |
Verze rozhraní .NET Framework, která se použije ke kompilaci vygenerovaného kódu. Podporované verze jsou 4 a 4.5. Výchozí hodnota je 4. |
V tomto oddílu
Postupy: Použití EdmGen.exe pro generování modelu a souborů mapování
Postupy: Použití EdmGen.exe pro generování kódu na objektové vrstvě
Postupy: Použití EdmGen.exe pro ověření modelu a souborů mapování