Sdílet prostřednictvím

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

  • Článek

Nástroj pro export metadat prostředí Windows Runtime (Winmdexp.exe) transformuje modul rozhraní .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 prostředí Windows Runtime Součásti. Proces převodu modulu rozhraní .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 komponenty 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 .winmd. Toto je doporučený způsob sestavení komponenty prostředí Windows Runtime. Jestliže chcete mít lepší kontrolu nad procesem sestavení, než jakou poskytuje sada Visual Studio, použijte přímo nástroj Winmdexp.exe.

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ý má být exportován. Je povolen pouze jeden modul. K vytvoření tohoto modulu použijte možnost kompilátoru /target winmdobj 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ý bude vytvořen nástrojem Winmdexp.exe. 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 Windows (.winmd).
/pdb: symbolfile

/p: symbolfile		 Určuje název výstupního souboru databáze programu (PDB), který bude obsahovat symboly pro exportovaný soubor metadat Windows (.winmd).
/reference: winmd

/r: winmd		 Určuje referenční soubor metadat (.winmd nebo sestavení) používaný při exportu. Pokud použijete referenční sestavení v \Program Files (x86)\Referenční sestavení\Microsoft\Framework\. NETCore\v4.5" ("\Program Files\..." v 32bitových počítačích) zahrnují odkazy na System.Runtime.dll i mscorlib.dll.
/utf8output Určuje, že výstupní zpráva má být v kódování UTF-8.
/warnaserror+ Určuje, že všechna upozornění mají být považována 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

Nástroj Winmdexp.exe není určen pro převod 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 prostředí Windows Runtime typy. Další informace naleznete v části Deklarování typů v části prostředí Windows Runtime Součásti v článku Vytváření komponent prostředí Windows Runtime v jazyce C# a Visual Basic.

Při psaní aplikace pro Windows 8.x Store nebo komponenty prostředí Windows Runtime pomocí jazyka C# nebo Visual Basic poskytuje rozhraní .NET Framework podporu programování s prostředí 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 jsou některé běžně používané typy prostředí Windows Runtime mapovány 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> rozhraní.

Viz také