Assembler MSIL (Ilasm.exe)

Assembler MSIL genera un file eseguibile portabile (PE, Portable Executable) dal linguaggio MSIL (Microsoft Intermediate Language). Per ulteriori informazioni su MSIL, vedere Compilazione in MSIL. È possibile eseguire il file eseguibile così ottenuto, contenente MSIL e i metadati necessari, per determinare se MSIL viene eseguito come previsto.

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

Parametri

Note

Assembler MSIL consente ai fornitori di strumenti di progettare e implementare generatori MSIL. Grazie a Ilasm.exe, gli sviluppatori che si occupano di strumenti e di compilazione possono concentrarsi sulla generazione di metadati e su MSIL senza doversi preoccupare di emettere MSIL nel formato di file PE.

Analogamente ad altri compilatori basati su runtime, quali C# e Visual Basic, Ilasm.exe non produce file oggetto intermedi e non richiede alcuna fase di collegamento per creare un file PE.

Assembler MSIL è in grado di esprimere tutte le funzionalità esistenti per MSIL e i metadati dei linguaggi di programmazione basati su runtime. In questo modo il codice gestito scritto in uno qualsiasi di questi linguaggi di programmazione può essere espresso in Assembler MSIL e compilato con Ilasm.exe in modo appropriato.

È possibile utilizzare Ilasm.exe unitamente allo strumento cui è abbinato, Ildasm.exe. Ildasm.exe opera su un file PE contenente codice MSIL e crea un file di testo adatto come input per Ilasm.exe. Questo è utile, ad esempio, quando si compila il codice in un linguaggio di programmazione che non supporta tutti gli attributi di metadati del runtime. Dopo aver compilato il codice ed eseguito l'output tramite Ildasm.exe, il file di testo MSIL ottenuto potrà essere modificato manualmente per aggiungere gli attributi mancanti. Sarà quindi possibile eseguire questo file di testo mediante Ilasm.exe per produrre un file eseguibile finale.

È inoltre possibile ricorrere a questa tecnica per produrre un unico file PE sulla base di più file PE generati da diversi compilatori.

Per utilizzare unitamente Ildasm.exe e Ilasm.exe con la maggior accuratezza possibile, nell'assembler non vengono eseguite alcune semplici ottimizzazioni, ovvero non si deduce se utilizzare forme di istruzioni brevi o lunghe. Mediante tale strumento, ad esempio, non si tenta di determinare se sia possibile sostituire una codifica breve con una codifica lunga scritta nelle origini MSIL o emessa da un altro compilatore. Se si desidera la codifica breve, sarà necessario scrivere esplicitamente tale forma. Laddove possibile, viene tuttavia effettuato un controllo dei riferimenti o valori non compresi nell'intervallo.

Esempi

Il comando che segue assembla il file MSIL myTestFile.il e produce l'eseguibile myTestFile.exe.

ilasm myTestFile

Il comando che segue assembla il file MSIL myTestFile.il e produce il file DLL myTestFile.dll.

ilasm myTestFile /dll 

Il comando che segue assembla il file MSIL myTestFile.il e produce il file DLL myNewTestFile.dll.

ilasm myTestFile /dll /output:myNewTestFile.dll

Nell'esempio di codice riportato di seguito viene illustrata un'applicazione molto semplice che determina la visualizzazione della stringa "Hello World!" sulla console. È possibile compilare questo codice e quindi utilizzare lo strumento Ildasm.exe per generare un file MSIL.

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

L'esempio di codice MSIL riportato di seguito corrisponde al precedente esempio di codice C#. È possibile compilare questo codice in un assembly mediante lo strumento Assembler MSIL (Ilasm.exe). Entrambi gli esempi determinano la visualizzazione di "Hello World!" sulla console.

// 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

Vedere anche

Riferimenti

Strumenti di .NET Framework
Disassembler MSIL (Ildasm.exe)
Prompt dei comandi di SDK

Concetti

Compilazione in MSIL