Ilasm.exe (Assembler IL)

L'assembler IL genera un file eseguibile portabile (PE) dall'assembly intermedio del linguaggio (IL). Per altre informazioni su IL, vedere Processo di esecuzione gestita. È possibile eseguire il file eseguibile risultante, che contiene IL e i metadati necessari, per determinare se il servizio il esegue come previsto.

Viene installato automaticamente con Visual Studio. Per eseguire lo strumento, usare il prompt dei comandi per gli sviluppatori di Visual Studio o Visual Studio Developer PowerShell.

Al prompt dei comandi digitare quanto segue:

Sintassi

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

Parametri

Argomento	Descrizione
filename	Nome del file di origine .il. Questo file è formato da direttive di dichiarazione di metadati e istruzioni IL simboliche. È possibile fornire più argomenti di file di origine per produrre un unico file PE con Ilasm.exe. Nota: verificare che nell'ultima riga di codice del file di origine con estensione il sia presente uno spazio vuoto finale o un carattere di fine riga.

Opzione	Descrizione
/32bitpreferred	Crea un'immagine con preferenza per i 32 bit (PE32).
/allineamento: integer	Imposta FileAlignment sul valore specificato da integer nell'intestazione NT facoltativa. Se la direttiva IL .alignment è specificata nel file, questa opzione ne esegue l'override.
/appcontainer	Genera un file .dll o .exe che viene eseguito nel contenitore delle app Windows, come output.
/arm	Specifica Advanced RISC Machine (ARM) come processore di destinazione. Se non viene specificato il numero di bit dell'immagine, viene utilizzata l'impostazione predefinita /32bitpreferred.
/base: integer	Imposta ImageBase sul valore specificato da integer nell'intestazione NT facoltativa. Se la direttiva IL .imagebase è specificata nel file, questa opzione ne esegue l'override.
/clock	Misura e segnala i seguenti tempi di compilazione in millisecondi per il file di origine .il specificato: Total Run: tempo totale impiegato per l'esecuzione di tutte le operazioni specifiche che seguono. Startup: caricamento e apertura del file. Emitting MD: emissione di metadati. Ref to Def Resolution: risoluzione dei riferimenti nelle definizioni nel file. CEE File Generation: generazione dell'immagine del file in memoria. PE File Writing: scrittura dell'immagine in un file PE.
/debug[:IMPL|OPT]	Include informazioni di debug (nomi di variabili locali e di argomenti e numeri di riga). Crea un file PDB. Se si specifica/debug senza altri valori, viene disabilitata l'ottimizzazione JIT e vengono utilizzati i punti di sequenza dal file PDB. IMPL disabilita l'ottimizzazione JIT e utilizza punti di sequenza impliciti. OPT abilita l'ottimizzazione JIT e utilizza punti di sequenza impliciti.
/dll	Produce un file .dll come output.
/Enc: file	Crea file differenziali di Modifica e continuazione a partire dal file di origine specificato. Questo argomento è esclusivamente per utilizzo didattico e non è supportato per un utilizzo commerciale.
/exe	Produce un file eseguibile come output. Si tratta dell'impostazione predefinita.
/Bandiere: integer	Imposta ImageFlags sul valore specificato da integer nell'intestazione Common Language Runtime. Se la direttiva IL .corflags è specificata nel file, questa opzione ne esegue l'override. Per un elenco di valori validi per integer, vedere CorHdr.h, COMIMAGE_FLAGS.
/fold	Raggruppa corpi di metodo identici in uno solo.
/highentropyva	Genera in output un file eseguibile che supporta ASLR (Address Space Layout Randomization) a entropia elevata. Impostazione predefinita per /appcontainer.
/includere: includePath	Imposta un percorso per la ricerca di file inclusi con #include.
/itanium	Specifica Intel Itanium come processore di destinazione. Se non viene specificato il numero di bit dell'immagine, viene utilizzata l'impostazione predefinita /pe64.
/chiave: keyFile	Compila filename con una firma sicura usando la chiave privata contenuta in keyFile.
/key: @keySource	Compila filename con una firma sicura usando la chiave privata prodotta in keySource.
/listing	Produce un file di elenco sull'output standard. Se si omette questa opzione, non verrà prodotto alcun file di elenco. Questo parametro non è supportato in .NET Framework 2.0 o versione successiva.
/mdv: versionString	Imposta la stringa di versione dei metadati.
/msv: major.minor	Imposta la versione del flusso di metadati, dove major e minor sono numeri interi.
/noautoinherit	Disabilita l'ereditarietà predefinita da Object quando non è specificata alcuna classe base.
/nocorstub	Elimina la generazione dello stub CORExeMain.
/nologo	Evita la visualizzazione del messaggio di avvio Microsoft.
/prodotto: file.ext	Specifica il nome e l'estensione del file di output. Per impostazione predefinita, il nome del file di output corrisponde al nome del primo file di origine. L'estensione predefinita è .exe. Se si specifica l'opzione /dll, l'estensione predefinita sarà .dll. Nota: se si specifica /output:myfile.dll, non verrà impostata l'opzione /dll. Se non si specifica /dll, si otterrà un file eseguibile denominato myfile.dll.
/optimize	Ottimizza le istruzioni long convertendole in short. Ad esempio, br viene convertito in br.s.
/pe64	Crea un'immagine a 64 bit (PE32+). Se non è specificato il processore di destinazione, l'impostazione predefinita è /itanium.
/pdb	Crea un file PDB senza abilitare la traccia delle informazioni di debug.
/quiet	Specifica la modalità non interattiva. Non visualizza informazioni sullo stato dell'assembly.
/risorsa: file.res	Include il file di risorse specificato nel formato *.res nel file .exe o .dll risultante. È possibile specificare un unico file .res con l'opzione /resource .
/ssver: int.int	Imposta il numero di versione del sottosistema nell'intestazione NT facoltativa. Per /appcontainer e /arm il numero minimo di versione è 6.02.
/pila: stackSize	Imposta su stackSizeil valore di SizeOfStackReserve nell'intestazione NT facoltativa.
/stripreloc	Specifica che non sono necessarie rilocazioni di base.
/sottosistema: integer	Imposta il sottosistema sul valore specificato da integer nell'intestazione NT facoltativa. Se la direttiva IL .subsystem è specificata nel file, questo comando ne esegue l'override. Per un elenco di valori validi per integer, vedere winnt.h, IMAGE_SUBSYSTEM.
/x64	Specifica un processore AMD a 64 bit come processore di destinazione. Se non viene specificato il numero di bit dell'immagine, viene utilizzata l'impostazione predefinita /pe64.
/?	Visualizza la sintassi e le opzioni di comando dello strumento.

Nota

Tutte le opzioni di Ilasm.exe non sono soggette alla distinzione tra maiuscole e minuscole e vengono riconosciute dalle prime tre lettere. Ad esempio, /lis equivale a /listing e /res:myresfile.res equivale a /resource:myresfile.res. Opzioni che specificano argomenti accettano due punti (:) o un segno di uguale (=) come separatore tra l'opzione e l'argomento. /output:file.ext, ad esempio, equivale a /output=file.ext.

Osservazioni:

L'assembler IL consente ai fornitori di strumenti di progettare e implementare generatori IL. Grazie a Ilasm.exe, gli sviluppatori di strumenti e compilatori possono concentrarsi su IL e sulla generazione di metadati senza doversi preoccupare di emettere IL nel formato di file di tipo PE.

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

L'assembler IL è in grado di esprimere tutte le funzionalità esistenti per IL e i metadati dei linguaggi di programmazione destinati al runtime. In questo modo il codice gestito scritto in uno qualsiasi di questi linguaggi di programmazione può essere espresso nell'assembler IL e compilato con Ilasm.exe in modo appropriato.

Nota

È possibile che la compilazione abbia esito negativo se nell'ultima riga di codice del file di origine con estensione il non è presente uno spazio vuoto finale o un carattere di fine riga.

È possibile utilizzare Ilasm.exe unitamente allo strumento complementare Ildasm.exe. Ildasm.exe accetta un file di tipo PE contenente codice IL e crea un file di testo adatto come input per Ilasm.exe. Questo è utile, ad esempio, quando si compila codice in un linguaggio di programmazione che non supporta tutti gli attributi dei metadati del runtime. Dopo aver compilato il codice ed eseguito l'output tramite Ildasm.exe, il file di testo IL ottenuto potrà essere modificato manualmente per aggiungere gli attributi mancanti. Sarà quindi possibile elaborare 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.

Nota

Attualmente non è possibile avvalersi di questa tecnica con file PE contenenti codice nativo incorporato, ad esempio file PE prodotti da Visual C++.

Per fare in modo che l'utilizzo combinato di Ildasm.exe e Ilasm.exe risulti il più accurato possibile, per impostazione predefinita l'assembler non sostituisce le codifiche short con quelle long che potrebbero essere state scritte nelle origini IL (o che potrebbero essere state emesse da un altro compilatore). Utilizzare l'opzione /optimize per sostituire le codifiche short quando possibile.

Nota

Ildasm.exe opera solo su file su disco. e non su file installati nella Global Assembly Cache.

Per altre informazioni sulla grammatica di IL, vedere il file asmparse.grammar in Windows SDK.

Informazioni sulla versione

A partire da .NET Framework 4.5, è possibile associare un attributo personalizzato a un'implementazione dell'interfaccia usando codice simile al seguente:

.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 )
      …

A partire da .NET Framework 4.5, è possibile specificare un BLOB di marshalling arbitrario (oggetto binario di grandi dimensioni) usando la relativa rappresentazione binaria non elaborata, come illustrato nel codice seguente:

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

Per altre informazioni sulla grammatica di IL, vedere il file asmparse.grammar in Windows SDK.

Esempi

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

ilasm myTestFile

Il comando che segue assembla il file IL myTestFile.il e produce il file .dllmyTestFile.dll.

ilasm myTestFile /dll

Il comando che segue assembla il file IL myTestFile.il e produce il file .dllmyNewTestFile.dll.

ilasm myTestFile /dll /output:myNewTestFile.dll

L'esempio di codice seguente mostra un'applicazione estremamente semplice che visualizza "Hello World!" nella console. È possibile compilare questo codice e quindi utilizzare lo strumento Ildasm.exe per generare un file IL.

using System;

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

L'esempio di codice IL riportato di seguito corrisponde al precedente esempio di codice C#. È possibile compilare questo codice in un assembly mediante lo strumento IL Assembler. Sia gli esempi di codice IL che C# visualizzano "Hello World!" nella 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

Vedi anche

• Strumenti
• Ildasm.exe (Disassembler IL)
• Managed Execution Process
• Shell della riga di comando per sviluppatori