Ildasm.exe（IL 反汇编程序）

IL 反汇编程序是 IL 汇编程序 (Ilasm.exe) 的配套工具。 Ildasm.exe 可利用包含中间语言 (IL) 代码的可移植可执行 (PE) 文件，并创建适合输入到 Ilasm.exe 的文本文件 。

此工具会自动随 Visual Studio 一起安装。 若要运行该工具，请使用 Visual Studio 开发人员命令提示或 Visual Studio 开发人员 PowerShell。

在命令提示符处，键入以下内容：

语法

ildasm [options] [PEfilename] [options]

参数

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

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

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

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

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

注解

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

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

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

如果为 Ildasm.exe 提供一个包含嵌入资源的 PEfilename 参数，则此工具生成多个输出文件：一个包含 IL 代码的文本文件，以及与每个嵌入的托管资源对应的 .resources 文件（使用该资源在元数据中的名称生成） 。 如果 PEfilename 中嵌入了非托管资源，则通过 /output 选项使用 IL 输出指定的文件名生成 .res 文件。

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

版本信息

从 .NET Framework 4.5 开始，Ildasm.exe 将通过显示原始二进制内容来处理无法识别的封送 BLOB（二进制大型对象）。 例如，下面的代码演示 C# 程序生成的封送 BLOB 如何显示：

public void Test([MarshalAs((short)70)] int test) { }

// IL from Ildasm.exe output
.method public hidebysig instance void Test(int32  marshal({ 46 }) test) cil managed

从 .NET Framework 4.5 开始，Ildasm.exe 将显示应用于接口实现的属性，如下方 Ildasm.exe 输出摘录所示：

.class public auto ansi beforefieldinit MyClass
  extends [mscorlib]System.Object
  implements IMyInterface
  {
    .interfaceimpl type IMyInterface
    .custom instance void
      [mscorlib]System.Diagnostics.DebuggerNonUserCodeAttribute::.ctor() = ( 01 00 00 00 )
      …

示例

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

ildasm myHello.exe

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

ildasm MyFile.exe /output:MyFile.il

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

ildasm MyFile.exe /text

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

ildasm MyApp.exe /output:MyApp.il

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

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

在上面的示例中，可能有几个具有不同签名的名为 MyMethod 的方法。 以下命令使用返回类型和void参数类型和参数类型int32string反汇编实例方法MyMethod。

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

若要检索 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（IL 汇编程序）
• 托管执行过程
• 开发人员命令行 shell