Ilasm.exe (IL 組譯工具)

IL 組譯工具可從中繼語言 (IL) 組件中產生可攜式執行檔 (PE)。 (如需 IL 的詳細資訊，請參閱受控執行程序。) 您可以執行產生的可執行檔 (包含 IL 和所需的中繼資料)，來判斷 IL 是否如預期般地執行。

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

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

語法

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

參數

備註

IL 組譯工具可協助工具廠商設計及實作 IL 產生器。 使用 Ilasm.exe 工具可讓編譯器開發人員專注於 IL 和中繼資料的產生，而不需考慮使用 PE 檔格式發出 IL。

類似其他以執行階段為目標的編譯器 (例如 C# 和 Visual Basic)，Ilasm.exe 並不會產生中繼目的檔，而且不需要連結階段來形成 PE 檔。

IL 組譯工具可以表示所有現有的中繼資料和以執行階段為目標之程式語言的 IL 功能。 這樣以這些程式語言中任何一種所撰寫的 Managed 程式碼都能在 IL 組譯工具中適當表示，並且以 Ilasm.exe 編譯。

您可以將 Ilasm.exe 和其附屬工具 Ildasm.exe 結合使用。 Ildasm.exe 使用包含 IL 程式碼的 PE 檔，建立適合作為 Ilasm.exe 輸入的文字檔。 這非常有用，例如在不支援所有執行階段中繼資料屬性的程式語言中編譯程式碼時。 編譯完程式碼並透過 Ildasm.exe 執行輸出後，可以手動編輯產生的 IL 文字檔來新增遺漏的屬性。 然後可以透過 Ilasm.exe 執行這個文字檔來產生最終的可執行檔。

您也可以使用這項技術來由不同編譯器所原始產生的數個 PE 檔中產生單一 PE 檔。

為了使 Ildasm.exe 和 Ilasm.exe 的合併使用盡可能精確，根據預設，組譯工具不會將您可能在 IL 來源中撰寫的較長 (或可能已經由其他編譯器發出的) 編碼替換為較短的編碼。 使用 /optimize 選項在可能的情況下替代短編碼方式。

如需 IL 文法的詳細資訊，請參閱 Windows SDK 中的 asmparse.grammar 檔案。

版本資訊

從 .NET Framework 4.5 開始，您可以使用類似下列的程式碼，將自訂屬性附加至介面實作：

.class interface public abstract auto ansi IMyInterface
{
  .method public hidebysig newslot abstract virtual
    instance int32 method1() cil managed
  {
  } // end of method IMyInterface::method1
} // end of class IMyInterface
.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 )
      …

從 .NET Framework 4.5 開始，您可以使用原始二進位標記法指定任意封送處理 BLOB (二進位大型物件) ，如下列程式碼所示：

.method public hidebysig abstract virtual
        instance void
        marshal({ 38 01 02 FF })
        Test(object A_1) cil managed

如需 IL 文法的詳細資訊，請參閱 Windows SDK 中的 asmparse.grammar 檔案。

範例

下列命令會組譯 IL 檔 myTestFile.il，並產生可執行檔 myTestFile.exe。

ilasm myTestFile

下列命令會組譯 IL 檔 myTestFile.il，並產生 .dll檔案 myTestFile.dll。

ilasm myTestFile /dll

下列命令會組譯 IL 檔 myTestFile.il，並產生 .dll檔案 myNewTestFile.dll。

ilasm myTestFile /dll /output:myNewTestFile.dll

下列程式碼範例會顯示極為簡單的應用程式，將 "Hello World!" 顯示到主控台。 您可以編譯此程式碼，然後使用 Ildasm.exe 工具來產生 IL 檔案。

using System;

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

下列 IL 程式碼範例會對應至之前的 C# 程式碼範例。 您可以使用 IL 組譯工具，將這個程式碼編譯為組件。 IL 和 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

另請參閱

• 工具
• Ildasm.exe (IL 反組譯工具)
• Managed 執行程序
• 開發人員命令列殼層