Winmdexp.exe (narzędzie eksportowania metadanych środowiska wykonawczego systemu Windows)
Narzędzie środowisko wykonawcze systemu Windows Metadata Export Tool (Winmdexp.exe) przekształca moduł .NET Framework w plik zawierający metadane środowisko wykonawcze systemu Windows. Mimo że zestawy programu .NET Framework i pliki metadanych środowisko wykonawcze systemu Windows używają tego samego formatu fizycznego, istnieją różnice w zawartości tabel metadanych, co oznacza, że zestawy programu .NET Framework nie są automatycznie używane jako składniki środowisko wykonawcze systemu Windows. Proces przekształcania modułu .NET Framework w składnik środowisko wykonawcze systemu Windows jest określany jako eksportowanie. W programach .NET Framework 4.5 i 4.5.1 wynikowy plik metadanych systemu Windows (winmd) zawiera metadane i implementację.
Jeśli używasz szablonu składnika środowisko wykonawcze systemu Windows, który znajduje się w Sklepie Windows dla języka C# i Visual Basic w programie Visual Studio 2013 lub Visual Studio 2012, obiekt docelowy kompilatora jest plikiem winmdobj, a kolejne wywołania kroku kompilacji Winmdexp.exe wyeksportować plik winmdj do pliku winmdj. Jest to zalecany sposób tworzenia składnika środowisko wykonawcze systemu Windows. Programu Winmdexp.exe należy używać bezpośrednio, gdy potrzebna jest większa kontrola nad procesem kompilacji niż dostępna w Visual Studio.
To narzędzie jest instalowane automatycznie z programem Visual Studio. Aby uruchomić narzędzie, użyj wiersza polecenia dla deweloperów programu Visual Studio lub programu Visual Studio Developer PowerShell.
W wierszu polecenia wpisz:
Składnia
winmdexp [options] winmdmodule
Parametry
| Argument lub opcja | opis |
|---|---|
winmdmodule |
Określa moduł (winmdobj) do wyeksportowania. Dozwolony jest tylko jeden moduł. Aby utworzyć ten moduł, użyj /target opcji kompilatora z elementem winmdobj docelowym. Zobacz -target:winmdobj (opcje kompilatora C#) lub -target (Visual Basic). |
/docfile: docfile/d: docfile |
Określa wyjściowy plik dokumentacji XML, który zostanie wygenerowany przez Winmdexp.exe. W programie .NET Framework 4.5 plik wyjściowy jest zasadniczo taki sam jak wejściowy plik dokumentacji XML. |
/moduledoc: docfile/md: docfile |
Określa nazwę pliku dokumentacji XML, który kompilator wygenerował za pomocą winmdmodulepolecenia . |
/modulepdb: symbolfile/mp: symbolfile |
Określa nazwę pliku bazy danych programu (PDB), który zawiera symbole .winmdmodule |
/nowarn: warning |
Wyłącza ostrzeżenie o podanym numerze. W przypadku ostrzeżenia podaj tylko część liczbową kodu błędu bez zer wiodących. |
/out: file/o: file |
Określa nazwę wyjściowego pliku metadanych systemu Windows (winmd). |
/pdb: symbolfile/p: symbolfile |
Określa nazwę wyjściowego pliku bazy danych programu (PDB), który będzie zawierał symbole dla eksportowanego pliku metadanych systemu Windows (winmd). |
/reference: winmd/r: winmd |
Określa plik metadanych (winmd lub zestaw) jako plik referencyjny podczas eksportowania. Jeśli używasz zestawów odwołań w folderze "\Program Files (x86)\Reference Assemblies\Microsoft\Framework\. NETCore\v4.5" ("\Program Files\..." na komputerach 32-bitowych zawierają odwołania zarówno do System.Runtime.dll, jak i mscorlib.dll. |
/utf8output |
Określa, że komunikaty wyjściowe powinny mieć kodowanie UTF-8. |
/warnaserror+ |
Określa, że wszystkie ostrzeżenia powinny być traktowane jako błędy. |
@ responsefile |
Określa plik odpowiedzi (rsp), który zawiera opcje (i opcjonalnie winmdmodule). Każdy wiersz w pliku responsefile powinien zawierać jeden argument lub opcję. |
Uwagi
Winmdexp.exe nie jest przeznaczony do konwertowania dowolnego zestawu .NET Framework do pliku winmd. Wymaga modułu skompilowanego z opcją /target:winmdobj i zastosowania dodatkowych ograniczeń. Najważniejsze z tych ograniczeń jest to, że wszystkie typy uwidocznione na powierzchni interfejsu API zestawu muszą być środowisko wykonawcze systemu Windows typów. Aby uzyskać więcej informacji, zobacz sekcję "Deklarowanie typów w składnikach środowisko wykonawcze systemu Windows" w artykule Creating środowisko wykonawcze systemu Windows Components in C# and Visual Basic (Tworzenie składników środowisko wykonawcze systemu Windows w języku C# i Visual Basic).
Podczas pisania aplikacji ze Sklepu Windows 8.x lub składnika środowisko wykonawcze systemu Windows w języku C# lub Visual Basic platforma .NET Framework zapewnia obsługę programowania za pomocą środowisko wykonawcze systemu Windows bardziej naturalnego. Omówiono to w artykule .NET Framework Support for Windows Store Apps and środowisko wykonawcze systemu Windows (Obsługa platformy .NET Framework dla aplikacji ze Sklepu Windows i środowisko wykonawcze systemu Windows). W tym procesie niektóre powszechnie używane typy środowisko wykonawcze systemu Windows są mapowane na typy programu .NET Framework. Winmdexp.exe odwraca ten proces i tworzy powierzchnię interfejsu API, która używa odpowiednich typów środowisko wykonawcze systemu Windows. Na przykład typy skonstruowane z mapy interfejsu IList<T> do typów skonstruowanych z interfejsu środowisko wykonawcze systemu Windows IVector<T> interfejsu.
