大网数据广告活动
.NET 与 C# 开发

Winmdexp.exe(Windows 运行时元数据导出工具)

· 52CE 我爱测

Windows 运行时元数据导出工具 (Winmdexp.exe) 可将 .NET Framework 模块转换为包含 Windows 运行时元数据的文件。 尽管 .NET Framework 程序集和 Windows 运行时元数据文件使用相同的物理格式,但元数据表的内容有差别,这意味着 .NET Framework 程序集不可自动用作 Windows 运行时组件。 将 .NET Framework 模块转换为 Windows 运行时组件的过程称为“导出” 。 在 .NET Framework 4.5 和 .NET Framework 4.5.1 中,生成的 Windows 元数据 (.winmd) 文件同时包含元数据和实现。

Windows 运行时元数据导出工具 (Winmdexp.exe) 可将 .NET Framework 模块转换为包含 Windows 运行时元数据的文件。 尽管 .NET Framework 程序集和 Windows 运行时元数据文件使用相同的物理格式,但元数据表的内容有差别,这意味着 .NET Framework 程序集不可自动用作 Windows 运行时组件。 将 .NET Framework 模块转换为 Windows 运行时组件的过程称为“导出” 。 在 .NET Framework 4.5 和 .NET Framework 4.5.1 中,生成的 Windows 元数据 (.winmd) 文件同时包含元数据和实现。

使用 Windows 运行时组件 模板(在 C# 中,位于“Microsoft Store” 下;在 Visual Basic 中,位于 Visual Studio 2013 或 Visual Studio 2012 中)时,编译器目标是 .winmdobj 文件,后续生成步骤将调用 Winmdexp.exe 以将 .winmdobj 文件导出到 .winmd 文件。 这是生成 Windows 运行时组件的推荐方法。 当你对生成过程需要的控制超过 Visual Studio 所能提供的控制时,请直接使用 Winmdexp.exe。

此工具会自动随 Visual Studio 一起安装。 若要运行此工具,请使用 Visual Studio 开发人员命令提示(或 Windows 7 中的 Visual Studio 命令提示)。 有关详细信息,请参阅命令提示。

在命令提示符处,键入以下内容:

语法

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 指定包含 winmdmodule 的符号的程序数据库 (PDB) 文件的名称。
/nowarn: warning 禁止显示指定的警告编号。 对于警告,仅提供错误代码的数字部分(不包含前导零)。
/out: file /o: file 指定输出 Windows 元数据 (.winmd) 文件的名称。
/pdb: symbolfile /p: symbolfile 指定将包含导出的 Windows 元数据 (.winmd) 文件的符号的输出程序数据库 (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 运行时类型。 有关详细信息,请参阅 Windows 开发人员中心的文章在 C# 和 Visual Basic 中创建 Windows 运行时组件的“在 Windows 运行时组件中声明类型”一节。

当你使用 C# 或 Visual Basic 编写 Windows 8.x 应用商店应用或 Windows 运行时组件时,.NET Framework 将提供支持,使得利用 Windows 运行时进行编程更加自然。 Windows 应用商店应用和 Windows 运行时的 .NET Framework 支持一文中对此进行了讨论。 在该过程中,某些常用的 Windows 运行时类型将映射到 .NET Framework 类型。 Winmdexp.exe 将反转此过程并生成使用对应的 Windows 运行时类型的 API 图面。 例如,从 xref:System.Collections.Generic.IList`1 接口构造的类型将映射到从 Windows 运行时 IVector<T> 接口构造的类型。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpetrusha)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。