Winmdexp.exe (Windows-futtatókörnyezet metaadat-exportálási eszköz)
A Windows-futtatókörnyezet metaadat-exportálási eszköz (Winmdexp.exe) .NET-keretrendszer modult Windows-futtatókörnyezet metaadatokat tartalmazó fájllá alakítja át. Bár .NET-keretrendszer szerelvények és Windows-futtatókörnyezet metaadatfájlok ugyanazt a fizikai formátumot használják, a metaadattáblák tartalmában különbségek vannak, ami azt jelenti, hogy .NET-keretrendszer szerelvények nem használhatók automatikusan, mivel Windows-futtatókörnyezet összetevők. A .NET-keretrendszer modul Windows-futtatókörnyezet-összetevővé alakításának folyamatát exportálásnak nevezzük. A .NET-keretrendszer 4.5-ös és 4.5.1-ben az eredményként kapott Windows-metaadatfájl (.winmd) metaadatokat és implementációt is tartalmaz.
Ha a Windows-futtatókörnyezet Component sablont használja, amely a Windows Store for C# és a Visual Basic alatt található a Visual Studio 2013-ban vagy a Visual Studio 2012-ben, a fordító célja egy .winmdobj fájl, és egy későbbi buildelési lépés meghívja Winmdexp.exe, hogy exportálja a .winmdobj fájlt egy .winmd fájlba. Ez az ajánlott módja egy Windows-futtatókörnyezet összetevő összeállításának. Közvetlenül akkor használja Winmdexp.exe, ha a Visual Studio által biztosítottnál nagyobb mértékben szeretné szabályozni a buildelési folyamatot.
Ez az eszköz automatikusan telepítve van a Visual Studióval. Az eszköz futtatásához használja a Visual Studio fejlesztői parancssorát vagy a Visual Studio Developer PowerShellt.
A parancssorba írja be a következőt:
Syntax
winmdexp [options] winmdmodule
Paraméterek
| Argumentum vagy beállítás | Leírás |
|---|---|
winmdmodule |
Megadja az exportálni kívánt modult (.winmdobj). Csak egy modul engedélyezett. A modul létrehozásához használja a /target fordítót a winmdobj célhoz. Lásd: -target:winmdobj (C# Fordító beállításai) vagy -target (Visual Basic). |
/docfile: docfile/d: docfile |
Megadja a kimeneti XML-dokumentációs fájlt, amelyet Winmdexp.exe fog létrehozni. A .NET-keretrendszer 4.5-ben a kimeneti fájl lényegében megegyezik a bemeneti XML-dokumentációs fájllal. |
/moduledoc: docfile/md: docfile |
Megadja annak az XML-dokumentációs fájlnak a nevét, amellyel winmdmodulea fordító készített. |
/modulepdb: symbolfile/mp: symbolfile |
A programadatbázis (PDB) fájljának nevét adja meg, amely a program szimbólumait winmdmoduletartalmazza. |
/nowarn: warning |
Letiltja a megadott figyelmeztetési számot. Figyelmeztetésként csak a hibakód numerikus részét adja meg kezdő nullák nélkül. |
/out: file/o: file |
A kimeneti Windows-metaadatok (.winmd) fájl nevét adja meg. |
/pdb: symbolfile/p: symbolfile |
Megadja a kimeneti programadatbázis (PDB) fájljának nevét, amely az exportált Windows-metaadatfájl (.winmd) szimbólumait tartalmazza. |
/reference: winmd/r: winmd |
Az exportálás során hivatkozni kívánt metaadatfájlt (.winmd vagy assembly) határoz meg. Ha a referencia-szerelvényeket a "\Program Files (x86)\Reference Assemblies\Microsoft\Framework\ fájlban használja. NETCore\v4.5" ("\Program Files\..." 32 bites számítógépeken) System.Runtime.dll és mscorlib.dll hivatkozásokat is tartalmazhat. |
/utf8output |
Megadja, hogy a kimeneti üzeneteknek UTF-8 kódolásban kell lenniük. |
/warnaserror+ |
Megadja, hogy minden figyelmeztetést hibaként kell kezelni. |
@ responsefile |
A beállításokat (és opcionálisan winmdmodule) tartalmazó válaszfájlt (.rsp) adja meg. Minden sornak responsefile egyetlen argumentumot vagy beállítást kell tartalmaznia. |
Megjegyzések
Winmdexp.exe nem egy tetszőleges .NET-keretrendszer-szerelvény .winmd fájllá alakítására lett tervezve. Ehhez egy olyan modulra van szükség, amely a /target:winmdobj beállítással van lefordítva, és további korlátozások vonatkoznak rá. A korlátozások közül a legfontosabb, hogy a szerelvény API-felületén elérhető összes típusnak Windows-futtatókörnyezet típusúnak kell lennie. További információ: "Deklarálási típusok Windows-futtatókörnyezet összetevőkben" című szakasz a Windows-futtatókörnyezet-összetevők létrehozása C# és Visual Basic nyelven című szakaszában.
Ha Windows 8.x Áruházbeli alkalmazást vagy Windows-futtatókörnyezet összetevőt ír C# vagy Visual Basic használatával, a .NET-keretrendszer támogatja a programozást a Windows-futtatókörnyezet természetesebbé tétele érdekében. Erről .NET-keretrendszer Windows Áruházbeli alkalmazások és Windows-futtatókörnyezet támogatásáról szóló cikkben talál. A folyamat során néhány gyakran használt Windows-futtatókörnyezet típus .NET-keretrendszer típusra van leképezve. Winmdexp.exe megfordítja ezt a folyamatot, és létrehoz egy API-felületet, amely a megfelelő Windows-futtatókörnyezet típusokat használja. Például az interfésztérképből a IList<T> Windows-futtatókörnyezet IVector<T> interfészből létrehozott típusokig.
