MSIL 汇编程序 (Ilasm.exe)

MSIL 汇编程序从 Microsoft 中间语言 (MSIL) 生成可移植可执行的 (PE) 文件。（有关 MSIL 的更多信息，请参见 编译为 MSIL。）可以运行结果可执行文件（该文件包含 MSIL 和所需的元数据）以确定 MSIL 是否按预期执行。

ilasm [options] filename [[options]filename...]

参数

备注

MSIL 汇编程序有助于工具供应商设计和实现 MSIL 生成器。通过使用 Ilasm.exe，工具和编译器开发人员可以专注于生成 MSIL 和元数据，而无需考虑以 PE 文件格式发出 MSIL。

与面向运行库的其他编译器（如 C# 和 Visual Basic）类似，Ilasm.exe 不产生中间对象文件，并且不需要链接阶段即可形成 PE 文件。

MSIL 汇编程序可以表达以运行库为目标的编程语言的所有现有元数据和 MSIL 功能。这使得用上面任何编程语言编写的托管代码都可以在 MSIL 汇编程序中充分表达并且可以用 Ilasm.exe 编译。

可以将 Ilasm.exe 同它的伙伴工具 Ildasm.exe 一起使用。Ildasm.exe 采用包含 MSIL 代码的 PE 文件并创建相应的文本文件作为 Ilasm.exe 的输入。这很有用，例如当编译用并非支持所有运行库元数据属性的编程语言编写的代码时。通过 Ildasm.exe 编译该代码并运行输出后，可以手动编辑结果 MSIL 文本文件以添加缺少的属性。然后可以通过 Ilasm.exe 运行此文本文件以生成最终的可执行文件。

也可以使用此方法从最初由不同的编译器生成的数个 PE 文件生成一个 PE 文件。

为使 Ildasm.exe 和 Ilasm.exe 的这种组合使用尽可能准确，此汇编程序不执行某些简单的优化，即不推断是使用短格式指令还是使用长格式指令。例如，此工具不会尝试确定它是否可以用短编码替换长编码，这些长编码可能是在 MSIL 源中编写的，也可能是由其他编译器发出的。如果需要短编码，则必须显式编写该格式。但是，此汇编程序在可能的情况下，还是会检查是否有超出范围的条件。

有关 MSIL 语法的更多信息，请参见 .NET Framework SDK 中的 asmparse.grammar 文件。

示例

下面的命令对 MSIL 文件 myTestFile.il 进行汇编并产生可执行文件 myTestFile.exe.

ilasm myTestFile

下面的命令对 MSIL 文件 myTestFile.il 进行汇编并产生 .dll 文件 myTestFile.dll。

ilasm myTestFile /dll 

下面的命令对 MSIL 文件 myTestFile.il 进行汇编并产生 .dll 文件 myNewTestFile.dll。

ilasm myTestFile /dll /output:myNewTestFile.dll

下面的代码示例演示一个向控制台显示“Hello World!”的极其简单的应用程序。可编译此代码，然后使用 Ildasm.exe 工具生成 MSIL 文件。

using System;
public class Hello
{
    public static void Main(String[] args)
    {
        Console.WriteLine("Hello World!");
    }
}

下面的 MSIL 代码示例对应于前面的 C# 代码示例。可使用 MSIL 汇编程序 (Ilasm.exe) 工具将此代码编译为程序集。MSIL 和 C# 代码示例都向控制台显示“Hello World!”。

// Metadata version: v2.0.50215
.assembly extern mscorlib
{
  .publickeytoken = (B7 7A 5C 56 19 34 E0 89 )                         // .z\V.4..
  .ver 2:0:0:0
}
.assembly sample
{
  .custom instance void [mscorlib]System.Runtime.CompilerServices.CompilationRelaxationsAttribute::.ctor(int32) = ( 01 00 08 00 00 00 00 00 ) 
  .hash algorithm 0x00008004
  .ver 0:0:0:0
}
.module sample.exe
// MVID: {A224F460-A049-4A03-9E71-80A36DBBBCD3}
.imagebase 0x00400000
.file alignment 0x00000200
.stackreserve 0x00100000
.subsystem 0x0003       // WINDOWS_CUI
.corflags 0x00000001    //  ILONLY
// Image base: 0x02F20000


// =============== CLASS MEMBERS DECLARATION ===================

.class public auto ansi beforefieldinit Hello
       extends [mscorlib]System.Object
{
  .method public hidebysig static void  Main(string[] args) cil managed
  {
    .entrypoint
    // Code size       13 (0xd)
    .maxstack  8
    IL_0000:  nop
    IL_0001:  ldstr      "Hello World!"
    IL_0006:  call       void [mscorlib]System.Console::WriteLine(string)
    IL_000b:  nop
    IL_000c:  ret
  } // end of method Hello::Main

  .method public hidebysig specialname rtspecialname 
          instance void  .ctor() cil managed
  {
    // Code size       7 (0x7)
    .maxstack  8
    IL_0000:  ldarg.0
    IL_0001:  call       instance void [mscorlib]System.Object::.ctor()
    IL_0006:  ret
  } // end of method Hello::.ctor

} // end of class Hello

请参见

参考

.NET Framework 工具
MSIL 反汇编程序 (Ildasm.exe)
SDK 命令提示

概念

编译为 MSIL