Winmdexp.exe (Windows 執行階段中繼資料匯出工具)

  • 發行項

Windows 執行階段中繼資料匯出工具 (Winmdexp.exe) 會將 .NET Framework 模組轉換為包含 Windows 執行階段中繼資料的檔案。 雖然 .NET Framework 組件和 Windows 執行階段中繼資料檔案使用相同的實體格式，但是中繼資料資料表的內容有些差異，也就是說，.NET Framework 組件不會自動作為 Windows 執行階段元件使用。 將 .NET Framework 模組轉換為 Windows 執行階段元件的程序稱為「匯出」。 在 .NET Framework 4.5 和 4.5.1 中，產生的 Windows 中繼資料 (.winmd) 檔案同時包含中繼資料和實作。

當您使用 [Windows 執行階段元件] 範本時 (在 Visual Studio 2013 或 Visual Studio 2012 中位於 C# 和 Visual Basic 的 [Windows 市集] 底下)，編譯器目標是 .winmdobj 檔案，而後續建置步驟會呼叫 Winmdexp.exe 將 .winmdobj 檔案匯出到 .winmd 檔案。 這是建置 Windows 執行階段元件的建議方式。 如果您想要更充分掌控建置流程，超越 Visual Studio 所提供的範圍，請直接使用 Winmdexp.exe。

此工具會自動與 Visual Studio 一起安裝。 若要執行此工具，請使用 Visual Studio 開發人員命令提示字元或 Visual Studio 開發人員 PowerShell。

在命令提示字元中，請輸入下列項目：

語法

winmdexp [options] winmdmodule

參數

引數或選項 描述
winmdmodule 指定要匯出的模組 (.winmdobj)。 只允許一個模組。 若要建立這個模組，請使用 /target 編譯器選項搭配 winmdobj 目標。 請參閱 -target:winmdobj (C# 編譯器選項) 或 -target (Visual Basic)。
/docfile: docfile

/d: docfile		 指定 Winmdexp.exe 將產生的輸出 XML 文件檔。 在 .NET Framework 4.5 中，輸出檔基本上與輸入 XML 檔檔相同。
/moduledoc: docfile

/md: docfile		 指定編譯器使用 winmdmodule 所產生的 XML 文件檔名稱。
/modulepdb: symbolfile

/mp: symbolfile		 指定式資料庫 (PDB) 檔名稱，該檔案包含 winmdmodule 的符號。
/nowarn: warning 隱藏指定的警告編號。 對於 warning，僅提供錯誤碼的數字部分，不包含前置零。
/out: file

/o: file		 指定輸出 Windows 中繼資料 (.winmd) 檔的名稱。
/pdb: symbolfile

/p: symbolfile		 指定將包含所匯出 Windows 中繼資料 (.winmd) 檔之符號的輸出程式資料庫 (PDB) 檔 (PDB) 名稱。
/reference: winmd

/r: winmd		 指定匯出期間參考的中繼資料檔 (.winmd 或組件)。 如果您使用位於 "\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETCore\v4.5" 的參考組件 (在 32 位元電腦上位於 "\Program Files\...")，請同時包含 System.Runtime.dll 和 mscorlib.dll 的參考。
/utf8output 指定應該採用 UTF-8 編碼的輸出訊息。
/warnaserror+ 指定應該將所有警告視為錯誤。
@ responsefile 指定包含選項的回應檔 (.rsp) (以及選擇性的 winmdmodule)。 responsefile 中的每一行都應該包含單一引數或選項。

備註

Winmdexp.exe 的設計並不是將任意 .NET Framework 組件轉換成 .winmd 檔案。 它需要的是使用 /target:winmdobj 選項編譯的模組，並且適用其他限制。 這些限制中最重要的是，組件的 API 介面中公開的所有型別都必須是 Windows 執行階段型別。 如需詳細資訊，請參閱在 C# 和 Visual Basic 中建立 Windows 執行階段元件文件一文中的＜宣告 Windows 執行階段元件中的類型＞一節。

當您使用 C# 或 Visual Basic 撰寫 Windows 8.x Store 應用程式或 Windows 執行階段 元件時，.NET Framework提供支援，讓程式設計更自然Windows 執行階段。 這會在適用於 Windows 市集應用程式和 Windows 執行階段的 .NET Framework 支援文章中討論。 在過程中，有些常用的 Windows 執行階段型別會對應至 .NET Framework 型別。 Winmdexp.exe 會將這個過程反轉，並產生 API 介面來使用對應的 Windows 執行階段型別。 例如，建構自 IList<T> 介面的類型會對應到建構自 Windows 執行階段 IVector<T> 介面的類型。

另請參閱