Ildasm.exe（MSIL 反汇编程序）

更新：2011 年 4 月

MSIL 反汇编程序是 MSIL 汇编程序 (Ilasm.exe) 的伙伴工具。 Ildasm.exe 采用包含 Microsoft 中间语言 (MSIL) 代码的可迁移可执行 (PE) 文件，并创建相应的文本文件作为 Ilasm.exe 的输入。

安装 Visual Studio 和 Windows SDK 时会自动安装此工具。 要运行工具，我们建议您使用 Visual Studio 命令提示符或 Windows SDK 命令提示符（也称 CMD Shell）。 您可以使用这些实用程序轻松运行工具，而不需要导航到安装文件夹。 有关更多信息，请参见 Visual Studio 和 Windows SDK 命令提示。

• 如果您的计算机上已安装了 Visual Studio：在任务栏上依次单击 Start、All Programs、Visual Studio、Visual Studio Tools、Visual Studio Command Prompt。

  - 或 -

  如果您的计算机上已安装了 Windows SDK：在任务栏上依次单击 Start、All Programs、Windows SDK 文件夹和 Command Prompt（或CMD Shell)。

• 在命令提示处，键入下列命令：

ildasm [options] [PEfilename] [options]

参数

下列选项可用于 .exe、.dll、.obj 和 .lib 文件。

下列附加选项可用于 .exe 和 .dll 文件。

下列选项仅对用于文件或控制台输出的 .exe 和 .dll 文件有效。

选项	说明
/all	指定 /header、/bytes、/stats、/classlist 和 /tokens 选项的组合。 注意 在 .NET Framework 1.0 和 1.1 版中，指定 /header、/bytes 和 /tokens 选项的组合。
/classlist	包含模块中定义的类的列表。 .NET Framework 2.0 版的新增功能。
/forward	使用前向类声明。 .NET Framework 2.0 版的新增功能。
标头	在输出中包含文件头信息。
/item:类[::成员[(sig]]	根据所提供的参数反汇编下列内容： 反汇编指定的 class。 反汇编指定的 class 的 member。 反汇编具有指定签名 sig 的 class 的 member。 sig 的格式如下所示： [instance] returnType(parameterType1, parameterType2, …, parameterTypeN) 注意   在 .NET Framework 1.0 和 1.1 版中，sig 后面必须跟有右括号：(sig)。 在 2.0 版中，必须省略右括号：(sig。
/noil	取消 MSIL 程序集代码输出。
/stats	包含映像的统计信息。 .NET Framework 2.0 版的新增功能。
/typelist	生成类型的完整列表，以便在往返过程中保留类型排序。 .NET Framework 2.0 版的新增功能。
/unicode	对输出使用 Unicode 编码。
/utf8	对输出使用 UTF-8 编码。 默认值是 ANSI。

下列选项仅对用于文件或控制台输出的 .exe、.dll、.obj 和 .lib 文件有效。

下列选项仅对用于文件或控制台输出的 .lib 文件有效。

注意
Ildasm.exe 的所有选项不区分大小写，并且由前三个字母识别。例如，/quo 等效于 /quoteallnames。指定参数的选项既可以用冒号 (:) 也可以用等号 (=) 作为选项和参数之间的分隔符。例如，/output:filename 等效于 /output=filename。

备注

Ildasm.exe 只对磁盘上的 PE 文件进行操作。 它不对安装在全局程序集缓存中的文件进行操作。

Ildasm.exe 生成的文本文件可以用作 MSIL 汇编程序 (Ilasm.exe) 的输入。 这很有用，例如当编译用并非支持所有运行时元数据特性的编程语言编写的代码时。 通过 Ildasm.exe 编译该代码并运行输出后，可以手动编辑结果 MSIL 文本文件以添加缺少的特性。 然后可以通过 MSIL 汇编程序运行此文本文件以生成最终的可执行文件。

注意
目前，无法对包含嵌入的本机代码的 PE 文件（例如，由 Visual C++ 生成的 PE 文件）使用此技术。

可以使用 MSIL 反汇编程序中的默认 GUI，在分层树视图中查看任何现有 PE 文件的元数据和反汇编代码。 若要使用此 GUI，请在命令行中键入 ildasm，无需提供 PEfilename 参数或任何选项。 从**“文件”菜单，可以导航到要加载到 Ildasm.exe 中的 PE 文件。 若要保存为选定 PE 显示的元数据和反汇编代码，请从“文件”菜单选择“转储”命令。 若要只保存分层树视图，请在“文件”中选择“转储树视图”**命令。 有关将文件加载到 Ildasm.exe 中和解释输出的详细指南，请参见 Windows 软件开发包 (SDK) 附带的 Samples 文件夹中的 Ildasm.exe 教程。

如果用包含嵌入资源的 PEfilename 参数提供 Ildasm.exe，则此工具生成多个输出文件：一个包含 MSIL 代码的文本文件，而每个嵌入的托管资源都有一个用该资源在元数据中的名称生成的 .resources 文件。 如果 PEfilename中有嵌入的非托管资源，则用 /output 选项为 MSIL 输出指定的文件名生成 .res 文件。

注意
Ildasm.exe 只显示 .obj 和 .lib 输入文件的元数据说明。不反汇编这些文件类型的 MSIL 代码。

可以对 .exe 或 .dll 文件运行 Ildasm.exe 来确定该文件是否是托管的。 如果该文件不是托管的，则此工具将显示一条信息，说明该文件不包含有效的公共语言运行时头，并且无法反汇编。 如果该文件是托管的，则此工具将成功运行。

示例

下面的命令使 PE 文件 MyHello.exe 的元数据和反汇编代码显示在 Ildasm.exe 的默认 GUI 中。

ildasm myHello.exe

下面的命令对 MyFile.exe 文件进行反汇编，并将结果 MSIL 汇编程序文本存储在 MyFile.il 文件中。

ildasm MyFile.exe /output:MyFile.il

下面的命令对 MyFile.exe 文件进行反汇编，并将结果 MSIL 汇编程序文本显示到控制台窗口中。

ildasm MyFile.exe /text

如果文件 MyApp.exe 包含嵌入的托管和非托管资源，则下面的命令将产生以下 4 个文件：MyApp.il、MyApp.res、Icons.resources, 和 Message.resources：

ildasm MyApp.exe /output:MyApp.il

下面的命令对 MyFile.exe 的 MyClass 类中的 MyMethod 方法进行反汇编，并将输出显示到控制台窗口中。

ildasm /item:MyClass::MyMethod MyFile.exe /text

在上面的示例中，可能有几个具有不同签名的名为 MyMethod 的方法。 下面的命令对返回类型为 void 且参数类型为 int32 和 string 的 MyMethod 实例方法进行反汇编。

ildasm /item:"MyClass::MyMethod(instance void(int32,string)" MyFile.exe /text

注意
在 .NET Framework 1.0 和 1.1 版中，方法名称之后的左括号必须在签名后面匹配一个右括号：MyMethod(instance void(int32))。在 .NET Framework 2.0 版中，必须省略右括号：MyMethod(instance void(int32)。

若要检索 static 方法（在 Visual Basic 中为 Shared 方法），则省略关键字 instance。 不属于基元类型（例如 int32 和 string）的类类型必须包括命名空间并且必须在前面加上关键字 class。 外部类型的前面必须是用方括号括起来的库名称。 下面的命令对名为 MyMethod 的静态方法进行反汇编，该方法具有一个 AppDomain 类型的参数且其返回类型为 AppDomain。

ildasm /item:"MyClass::MyMethod(class [mscorlib]System.AppDomain(class [mscorlib]System.AppDomain)" MyFile.exe /text

嵌套类型的前面必须是它的包含类，并用正斜杠进行分隔。 例如，如果 MyNamespace.MyClass 类包含名为 NestedClass 的嵌套类，则按如下方式标识该嵌套类：class MyNamespace.MyClass/NestedClass。

请参见

参考

Ilasm.exe（MSIL 汇编程序）

Visual Studio 和 Windows SDK 命令提示

概念

托管执行过程

其他资源

.NET Framework 工具

修订记录