EDM-Generator (EdmGen.exe)
Bei EdmGen.exe handelt es sich um ein Befehlszeilentool, das gemeinsam mit Entitätsdatenmodells (EDMs) verwendet wird. Mit dem Tool EdmGen.exe können folgende Aufgaben ausgeführt werden:
Herstellen einer Verbindung zu einer Datenquelle mithilfe eines datenquellenspezifischen .NET Framework-Datenanbieters, und Erstellen der Dateien für das konzeptionelle Modell (CSDL), das Speichermodell (SSDL) und das Mapping (MSL), die vom EDM verwendet werden. Weitere Informationen finden Sie unter Gewusst wie: Verwenden von 'EdmGen.exe' zum Generieren eines Entity Data Model (Entity Framework).
Überprüfen eines bestehenden Modells. Weitere Informationen finden Sie unter Gewusst wie: Verwenden von 'EdmGen.exe' zum Validieren eines Entity Data Model.
Erstellen einer C#- oder Visual Basic-Codedatei, die die Objektklassen enthält, die aus einer Datei für das konzeptionelle Modell (CSDL) generiert wurden. Weitere Informationen finden Sie unter Gewusst wie: Verwenden von 'EdmGen.exe' zum Generieren von Objektmodelldateien (Entity Framework).
Generieren einer C#- oder Visual Basic-Codedatei, die die vorab generierten Sichten für ein vorhandenes Modell enthält. Weitere Informationen finden Sie unter Gewusst wie: Vorgenerieren von Sichten zur Verbesserung der Abfrageleistung (Entity Framework).
Das Tool EdmGen.exe wird im .NET Framework-Verzeichnis installiert. Dieses befindet sich meist unter C:\Windows\Microsoft.NET\Framework\v3.5. Zusätzlich können Sie mithilfe der Eingabeaufforderung von Visual Studio auf das Tool EdmGen.exe zugreifen. (Klicken Sie auf Start, zeigen Sie auf Programme, Microsoft Visual Studio 2008, Visual Studio Tools, und klicken Sie dann auf Visual Studio 2008-Eingabeaufforderung.)
EdmGen /mode:choice [options]
Modus
Wenn Sie das Tool EdmGen.exe verwenden, müssen Sie einen der folgenden Modi angeben.
| Modus | Beschreibung |
|---|---|
/mode:ValidateArtifacts |
Überprüft die CSDL-, SSDL- und MSL-Dateien und zeigt alle Fehler und Warnungen an. Diese Option erfordert mindestens eines der Argumente /inssdl oder /incsdl. Wenn /inmsl angegeben wird, sind auch die Argumente /inssdl und /incsdl erforderlich. |
/mode:FullGeneration |
Verwendet die in der /connectionstring-Option angegebenen Informationen zur Datenbankverbindung, und erstellt die CSDL-, SSDL-, .MSL-, Objektebenen- und Sichtdateien. Diese Option erfordert ein /connectionstring-Argument sowie entweder ein /project-Argument oder die Argumente /outssdl, /outcsdl, /outmsdl, /outobjectlayer, /outviews, /namespace oder /entitycontainer. |
/mode:FromSSDLGeneration |
Generiert CSDL- und MSL-Dateien, Quellcode und Sichten mithilfe der angegebenen SSDL-Datei. Diese Option erfordert das /inssdl-Argument und entweder ein /project-Argument oder die Argumente /outcsdl, /outmsl, /outobjectlayer, /outviews, /namespace, und /entitycontainer. |
/mode:EntityClassGeneration |
Erstellt eine Quellcodedatei, die die mithilfe der CSDL-Datei generierten Klassen enthält. Diese Option erfordert das /incsdl-Argument sowie das /project-Argument oder das /outobjectlayer-Argument. Das /language-Argument ist optional. |
/mode:ViewGeneration |
Erstellt eine Quellcodedatei, die die aus den CSDL-, SSDL- und MSL-Dateien generierten Sichten enthält. Diese Option erfordert die Argumente /inssdl, /incsdl und /inmsl, sowie das /project-Argument oder das /outviews-Argument. Das /language-Argument ist optional. |
Optionen
| Option | Beschreibung |
|---|---|
/p[roject]:<string> |
Gibt den zu verwendenden Projektnamen an. Der Projektname wird für die standardmäßige Namespaceeinstellung, die Namen der EDM-Dateien, den Namen der Objektquelldatei und den Namen der Quelldatei für das Generieren von Sichten verwendet. Der Entitätencontainername wird auf "<project>Context" festgelegt. |
/prov[ider]:<string> |
Der Name des .NET Framework-Datenanbieters zum Erstellen der Speichermodelldatei (SSDL). Der Standardanbieter ist der .NET Framework-Datenanbieter für SQL Server (System.Data.SqlClient). |
/c[onnectionstring]:<connection string> |
Gibt die Zeichenfolge an, die verwendet wird, um eine Verbindung mit der Datenquelle herzustellen. |
/incsdl:<file> |
Gibt die CSDL-Datei oder ein Verzeichnis an, in dem sich die CSDL-Dateien befinden. Dieses Argument kann mehrmals angegeben werden, damit Sie mehrere Verzeichnisse oder CSDL-Dateien angeben können. Das Angeben mehrerer Verzeichnisse ist beim Erstellen von Klassen (/mode:EntityClassGeneration) oder Sichten (/mode:ViewGeneration) hilfreich, wenn das konzeptionelle Modell in mehrere Dateien aufgeteilt ist. Dies kann auch nützlich sein, wenn Sie mehrere Modelle (/mode:ValidateArtifacts) überprüfen möchten. |
/refcsdl:<file> |
Gibt die zusätzliche CSDL-Datei bzw. -Dateien an, die verwendet werden, um die Verweise in der CSDL-Quelldatei aufzulösen. (Die CSDL-Quelldatei ist die mit der /incsdl-Option angegebene Datei). Die /refcsdl-Datei enthält Typen, von denen die CSDL-Quelldatei abhängt. Dieses Argument kann mehrmals angegeben werden. |
/inmsl:<file> |
Gibt die MSL-Datei oder ein Verzeichnis an, in dem sich die MSL-Dateien befinden. Dieses Argument kann mehrmals angegeben werden, um mehrere Verzeichnisse oder MSL-Dateien anzugeben. Das Angeben mehrerer Dateien ist beim Erstellen von Sichten (/mode:ViewGeneration) hilfreich, wenn das konzeptionelle Modell in mehrere Dateien aufgeteilt ist. Dies kann auch nützlich sein, wenn Sie mehrere Modelle überprüfen möchten (/mode:ValidateArtifacts). |
/inssdl:<file> |
Gibt die SSDL-Datei oder ein Verzeichnis an, in dem sich die SSDL-Datei befindet. |
/outcsdl:<file> |
Gibt den Namen der CSDL-Datei an, die erstellt wird. |
/outmsl:<file> |
Gibt den Namen der MSL-Datei an, die erstellt wird. |
/outssdl:<file> |
Gibt den Namen der SSDL-Datei an, die erstellt wird. |
/outobjectlayer:<file> |
Gibt den Namen der Quellcodedatei an, die die mit der CSDL-Datei generierten Objekte enthält. |
/outviews:<file> |
Gibt den Namen der Quellcodedatei an, die die generierten Sichten enthält. |
/language:[VB|CSharp] |
Gibt die Sprache für die erstellten Quellcodedateien an. Die Standardsprache ist C#. |
/namespace:<string> |
Gibt den zu verwendenden Namespace an. Der Namespace wird beim Ausführen von /mode:FullGeneration oder /mode:FromSSDLGeneration in der CSDL-Datei festgelegt. Beim Ausführen /mode:EntityClassGeneration wird der Namespace nicht verwendet. |
/entitycontainer:<string> |
Gibt den Namen an, der dem |
/help oder ? |
Zeigt die Befehlssyntax und Optionen für das Tool an. |
/nologo |
Unterdrückt die Anzeige der Copyrightmeldung. |