Generator EDM (EdmGen.exe)
EdmGen.exe to narzędzie wiersza polecenia używane do pracy z modelem platformy Entity Framework i plikami mapowania. Aby wykonać następujące czynności, możesz użyć narzędzia EdmGen.exe:
Połącz się ze źródłem danych przy użyciu dostawcy danych programu .NET Framework specyficznego dla źródła danych i wygeneruj model koncepcyjny (csdl), model magazynu (ssdl) i pliki mapowania (msl), które są używane przez program Entity Framework. Aby uzyskać więcej informacji, zobacz How to: Use EdmGen.exe to Generate the Model and Mapping Files (Instrukcje: używanie EdmGen.exe do generowania plików modelu i mapowania).
Zweryfikuj istniejący model. Aby uzyskać więcej informacji, zobacz How to: Use EdmGen.exe to Validate Model and Mapping Files (Jak używać EdmGen.exe do weryfikowania plików modelu i mapowania).
Wygeneruj plik kodu w języku C# lub Visual Basic zawierający klasy obiektów wygenerowane na podstawie pliku modelu koncepcyjnego (csdl). Aby uzyskać więcej informacji, zobacz How to: Use EdmGen.exe to Generate Object-Layer Code (Instrukcje: używanie EdmGen.exe do generowania kodu warstwy obiektów).
Wygeneruj plik kodu w języku C# lub Visual Basic zawierający wstępnie wygenerowane widoki dla istniejącego modelu. Aby uzyskać więcej informacji, instrukcje: wstępne generowanie widoków w celu zwiększenia wydajności zapytań.
Narzędzie EdmGen.exe jest instalowane w katalogu .NET Framework. W wielu przypadkach znajduje się to w folderze C:\windows\Microsoft.NET\Framework\v4.0. W przypadku systemów 64-bitowych znajduje się to w folderze C:\windows\Microsoft.NET\Framework64\v4.0. Możesz również uzyskać dostęp do narzędzia EdmGen.exe w wierszu polecenia programu Visual Studio (kliknij przycisk Start, wskaż pozycję Wszystkie programy, wskaż program Microsoft Visual Studio 2010, wskaż polecenie Visual Studio Tools, a następnie kliknij pozycję Wiersz polecenia programu Visual Studio 2010).
Składnia
EdmGen /mode:choice [options]
Tryb
W przypadku korzystania z narzędzia EdmGen.exe należy określić jeden z następujących trybów.
| Tryb | opis |
|---|---|
/mode:ValidateArtifacts |
Sprawdza poprawność plików .csdl, .ssdl i msl oraz wyświetla wszelkie błędy lub ostrzeżenia. Ta opcja wymaga co najmniej jednego z /inssdl argumentów lub /incsdl . Jeśli /inmsl zostanie określony, /inssdl argumenty i /incsdl są również wymagane. |
/mode:FullGeneration |
Używa informacji o połączeniu z bazą /connectionstring danych określonych w opcji i generuje pliki csdl, ssdl, msl, warstwy obiektów i wyświetlania plików.Ta opcja wymaga argumentu /connectionstring i argumentu /project , /outssdl/outcsdl, , /outmsdl, /outobjectlayer/outviews, , /namespacei /entitycontainer argumentów. |
/mode:FromSSDLGeneration |
Generuje pliki csdl i msl, kod źródłowy i widoki z określonego pliku ssdl. Ta opcja wymaga argumentu /inssdl i /project argumentu /outcsdl, , /outmsl, /outobjectlayer, /namespace/outviews, i /entitycontainer argumentów. |
/mode:EntityClassGeneration |
Tworzy plik kodu źródłowego zawierający klasy wygenerowane na podstawie pliku csdl. Ta opcja wymaga argumentu /incsdl i argumentu /project lub argumentu /outobjectlayer . Argument /language jest opcjonalny. |
/mode:ViewGeneration |
Tworzy plik kodu źródłowego zawierający widoki wygenerowane na podstawie plików csdl, ssdl i msl. Ta opcja wymaga argumentów /inssdl, , /incsdl/inmsli ./outviews /project Argument /language jest opcjonalny. |
Opcje
| Opcja | Opis |
|---|---|
/p[roject]:<string> |
Określa nazwę projektu do użycia. Nazwa projektu jest używana jako domyślna nazwa ustawienia przestrzeni nazw, nazwa modelu i plików mapowania, nazwa pliku źródłowego obiektu i nazwa pliku źródłowego generowania widoku. Nazwa kontenera jednostki jest ustawiona na <kontekst projektu>. |
/prov[ider]:<string> |
Nazwa dostawcy danych programu .NET Framework, który ma być używany do generowania pliku modelu magazynu (ssdl). Domyślnym dostawcą jest program .NET Framework Dostawca danych dla programu SQL Server (System.Data.SqlClient). |
/c[onnectionstring]:<parametry połączenia> |
Określa ciąg używany do nawiązywania połączenia ze źródłem danych. |
/incsdl:<plik> |
Określa plik csdl lub katalog, w którym znajdują się pliki csdl. Ten argument można określić wiele razy, aby można było określić kilka katalogów lub plików csdl. Określenie wielu katalogów może być przydatne w przypadku generowania klas (/mode:EntityClassGeneration) lub widoków (/mode:ViewGeneration), gdy model koncepcyjny jest podzielony na kilka plików. Może to być również przydatne, gdy chcesz zweryfikować wiele modeli (/mode:ValidateArtifacts). |
/refcsdl:<plik> |
Określa dodatkowy plik csdl lub pliki używane do rozpoznawania odwołań w źródłowym pliku csdl. (Źródłowy plik csdl to plik określony przez /incsdl opcję). Plik /refcsdl zawiera typy zależne od źródłowego pliku csdl. Ten argument można określić wiele razy. |
/inmsl:<plik> |
Określa plik msl lub katalog, w którym znajdują się pliki msl. Ten argument można określić wiele razy, aby można było określić kilka katalogów lub plików msl. Określenie wielu katalogów może być przydatne do generowania widoków (/mode:ViewGeneration), gdy model koncepcyjny jest podzielony na kilka plików. Może to być również przydatne, gdy chcesz zweryfikować wiele modeli (/mode:ValidateArtifacts). |
/inssdl:<plik> |
Określa plik .ssdl lub katalog, w którym znajduje się plik SSDL. Ten argument można określić wiele razy, aby można było określić kilka katalogów lub plików SSDL. Może to być przydatne, gdy chcesz zweryfikować wiele modeli (/mode:ValidateArtifacts). |
/outcsdl:<plik> |
Określa nazwę pliku csdl, który zostanie utworzony. |
/outmsl:<plik> |
Określa nazwę pliku msl, który zostanie utworzony. |
/outssdl:<plik> |
Określa nazwę pliku SSDL, który zostanie utworzony. |
/outobjectlayer:<plik> |
Określa nazwę pliku kodu źródłowego, który zawiera obiekty wygenerowane z pliku csdl. |
/outviews:<plik> |
Określa nazwę pliku kodu źródłowego, który zawiera widoki, które zostały wygenerowane. |
/language:[VB|CSharp] |
Określa język dla wygenerowanych plików kodu źródłowego. Język jest domyślnie w języku C#. |
/namespace:<string> |
Określa przestrzeń nazw modelu do użycia. Przestrzeń nazw jest ustawiana w pliku csdl podczas uruchamiania /mode:FullGeneration lub /mode:FromSSDLGeneration. Przestrzeń nazw nie jest używana podczas uruchamiania polecenia /mode:EntityClassGeneration. |
/entitycontainer:<string> |
Określa nazwę, która ma być stosowana do <EntityContainer> elementu w wygenerowanych plikach modelu i mapowania. |
/pl[uralize] |
Stosuje reguły języka angielskiego dla liczby pojedynczej i liczby mnogiej do EntityEntitySet, i NavigationProperty nazw w modelu koncepcyjnym. Ta opcja spowoduje wykonanie następujących akcji:- Utwórz wszystkie EntityType nazwy pojedyncze.— Wprowadź wszystkie EntitySet nazwy w liczbie mnogiej.- Dla każdego NavigationProperty , który zwraca co najwyżej jedną jednostkę, ustaw nazwę pojedynczą.— Dla każdego NavigationProperty , który zwraca więcej niż jedną jednostkę, wprowadź nazwę w liczbie mnogiej. |
/SuppressForeignKeyProperties or /nofk |
Zapobiega uwidacznianiu kolumn kluczy obcych jako właściwości skalarnych typów jednostek w modelu koncepcyjnym. |
/help lub ? |
Wyświetla składnię polecenia i opcje narzędzia. |
/nologo |
Pomija wyświetlanie wiadomości o prawach autorskich. |
/targetversion:<string> |
Wersja programu .NET Framework, która będzie używana do kompilowania wygenerowanego kodu. Obsługiwane wersje to 4 i 4.5. Wartość domyślna to 4. |
W tej sekcji
Instrukcje: Generowanie modelu i mapowania plików za pomocą EdmGen.exe
Instrukcje: Używanie EdmGen.exe, aby wygenerować kod warstwy obiektu
Instrukcje: Walidacja modelu i mapowania plików za pomocą EdmGen.exe