Winmdexp.exe (nástroj pro export metadat prostředí Windows Runtime)

Nástroj pro export metadat prostředí Windows Runtime (Winmdexp.exe) transformuje modul .NET Framework na soubor, který obsahuje metadata prostředí Windows Runtime. I když sestavení rozhraní .NET Framework a soubory metadat prostředí Windows Runtime používají stejný fyzický formát, existují rozdíly v obsahu tabulek metadat, což znamená, že sestavení rozhraní .NET Framework nejsou automaticky použitelná jako součásti prostředí Windows Runtime. Proces převodu modulu .NET Framework na komponentu Prostředí Windows Runtime se označuje jako export. V rozhraní .NET Framework 4.5 a 4.5.1 obsahuje výsledný soubor metadat Windows (.winmd) metadata i implementace.

Pokud použijete šablonu součásti prostředí Windows Runtime , která se nachází ve Windows Storu pro C# a Visual Basic v sadě Visual Studio 2013 nebo Visual Studio 2012, cíl kompilátoru je soubor .winmdobj a následný krok sestavení volá Winmdexp.exe k exportu souboru .winmdobj do souboru .winmdd. Toto je doporučený způsob, jak sestavit komponentu prostředí Windows Runtime. Winmdexp.exe používejte přímo, když chcete mít větší kontrolu nad procesem sestavení, než poskytuje Visual Studio.

Tento nástroj je automaticky nainstalován se sadou Visual Studio. Ke spuštění nástroje použijte Visual Studio Developer Command Prompt nebo Visual Studio Developer PowerShell.

Na příkazovém řádku zadejte následující:

Syntaxe

winmdexp [options] winmdmodule

Parametry

Argument nebo možnost Popis
winmdmodule Určuje modul (.winmdobj), který se má exportovat. Je povolen pouze jeden modul. K vytvoření tohoto modulu použijte možnost kompilátoru /targetwinmdobj s cílem. Viz -target:winmdobj (možnosti kompilátoru jazyka C#) nebo -target (Visual Basic).
/docfile: docfile

/d: docfile
Určuje výstupní soubor dokumentace XML, který Winmdexp.exe vytvoří. V rozhraní .NET Framework 4.5 je výstupní soubor v podstatě stejný jako vstupní soubor dokumentace XML.
/moduledoc: docfile

/md: docfile
Určuje název souboru dokumentace XML, který kompilátor vytvořil s winmdmodule.
/modulepdb: symbolfile

/mp: symbolfile
Určuje název souboru databáze programu (PDB), který obsahuje symboly pro winmdmodule.
/nowarn: warning Potlačí zadané číslo upozornění. Pro upozornění zadejte pouze číselnou část kódu chyby bez počátečních nul.
/out: file

/o: file
Určuje název výstupního souboru metadat Systému Windows (.winmd).
/pdb: symbolfile

/p: symbolfile
Určuje název souboru PDB (Output Program Database), který bude obsahovat symboly pro exportovaný soubor metadat Systému Windows (.winmd).
/reference: winmd

/r: winmd
Určuje soubor metadat (.winmd nebo sestavení), který se má během exportu odkazovat. Pokud použijete referenční sestavení v \Program Files (x86)\Referenční sestavení\Microsoft\Framework\. NETCore\v4.5" ("\Program Files\..." na 32bitových počítačích), včetně odkazů na System.Runtime.dll i mscorlib.dll.
/utf8output Určuje, že výstupní zprávy by měly být v kódování UTF-8.
/warnaserror+ Určuje, že se všechna upozornění mají považovat za chyby.
@ responsefile Určuje soubor odpovědi (.rsp), který obsahuje možnosti (a volitelně winmdmodule). Každý řádek by responsefile měl obsahovat jeden argument nebo možnost.

Poznámky

Winmdexp.exe není určen k převodu libovolného sestavení rozhraní .NET Framework na soubor .winmd. Vyžaduje modul kompilovaný s /target:winmdobj možností a platí další omezení. Nejdůležitější z těchto omezení je, že všechny typy, které jsou vystaveny na povrchu rozhraní API sestavení, musí být typy prostředí Windows Runtime. Další informace naleznete v části Deklarování typů v komponentách prostředí Windows Runtime v článku Vytváření komponent prostředí Windows Runtime v jazyce C# a Visual Basic.

Když píšete aplikaci pro Windows 8.x Store nebo komponentu prostředí Windows Runtime s C# nebo Visual Basicem, rozhraní .NET Framework poskytuje podporu programování s prostředím Windows Runtime přirozenější. Toto je popsáno v článku Podpora rozhraní .NET Framework pro aplikace pro Windows Store a prostředí Windows Runtime. V procesu se některé běžně používané typy prostředí Windows Runtime mapují na typy rozhraní .NET Framework. Winmdexp.exe tento proces obrátí a vytvoří povrch rozhraní API, který používá odpovídající typy prostředí Windows Runtime. Například typy vytvořené z IList<T> mapování rozhraní na typy vytvořené z rozhraní prostředí Windows Runtime IVector<T> .

Viz také