Udostępnij przez

Winmdexp.exe (narzędzie eksportowania metadanych środowiska uruchomieniowego systemu Windows)

Narzędzie eksportowania metadanych środowiska uruchomieniowego systemu Windows (Winmdexp.exe) przekształca moduł .NET Framework w plik zawierający metadane środowiska uruchomieniowego systemu Windows. Mimo że zestawy .NET Framework i pliki metadanych środowiska uruchomieniowego 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 środowiska uruchomieniowego systemu Windows. Proces przekształcania modułu .NET Framework w składnik środowiska uruchomieniowego 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ładnik środowiska uruchomieniowego 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 w celu wyeksportowania pliku winmdj do pliku winmd. Jest to zalecany sposób tworzenia składnika środowiska uruchomieniowego systemu Windows. Użyj Winmdexp.exe bezpośrednio, jeśli chcesz mieć większą kontrolę nad procesem kompilacji niż zapewnia program 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), który ma zostać wyeksportowany. 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 Winmdexp.exe zostanie wygenerowany. 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 Pomija określony numer ostrzeżenia. 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ę pliku bazy danych programu wyjściowego (PDB), który będzie zawierać symbole wyeksportowanego pliku metadanych systemu Windows (winmd).
/reference: winmd

/r: winmd 		Określa plik metadanych (winmd lub zestaw) do odwołania 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 być w kodowaniu 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 przeznaczona do konwertowania dowolnego zestawu .NET Framework na plik 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ć typami środowiska uruchomieniowego systemu Windows. Aby uzyskać więcej informacji, zobacz sekcję "Deklarowanie typów w składnikach środowiska uruchomieniowego systemu Windows" w artykule Tworzenie składników środowiska uruchomieniowego systemu Windows w języku C# i Visual Basic.

Podczas pisania aplikacji ze Sklepu Windows 8.x lub składnika środowiska uruchomieniowego systemu Windows w języku C# lub Visual Basic platforma .NET Framework zapewnia obsługę programowania w środowisku uruchomieniowym systemu Windows bardziej naturalnym. Omówiono to w artykule .NET Framework Support for Windows Store Apps and Windows Runtime (Obsługa programu .NET Framework dla aplikacji ze Sklepu Windows i środowiska uruchomieniowego systemu Windows). W tym procesie niektóre powszechnie używane typy środowiska uruchomieniowego 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 środowiska uruchomieniowego systemu Windows. Na przykład typy skonstruowane z mapy interfejsu IList<T> do typów skonstruowanych z interfejsu środowiska uruchomieniowego IVector<T> systemu Windows.

Zobacz także

  • Last updated on