Assembler MSIL (Ilasm.exe)
Aggiornamento: novembre 2007
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
Argomento |
Descrizione |
|---|---|
nomefile |
Il nome del file di origine IL. Questo file è formato da comandi per la dichiarazione di metadati e istruzioni MSIL 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 finale o un carattere di fine riga. |
Opzione |
Descrizione |
|---|---|
/alignment=integer |
Imposta FileAlignment sul valore specificato da integer nell'intestazione NT facoltativa. Se il comando IL .alignment è specificato nel file, questa opzione ne esegue l'override. |
/base=integer |
Imposta ImageBase sul valore specificato da integer nell'intestazione NT facoltativa. Se il comando IL .imagebase è specificato nel file, questa opzione ne esegue l'override. |
/clock |
Misura e riferisce 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 file nella memoria. PE File Writing: scrittura dell'immagine in un file PE. |
/debug[=IMPL|OPT] |
Include informazioni di debug (nomi di argomenti, variabili locali e numeri di riga). Crea un file PDB. Se si specifica /debug senza altri valori, viene disattivata l'ottimizzazione JIT e vengono utilizzati i punti di sequenza dal file PDB. IMPL disattiva l'ottimizzazione JIT e utilizza punti di sequenza impliciti. OPT attiva l'ottimizzazione JIT e utilizza punti di sequenza impliciti. IMPL e OPT sono nuovi valori introdotti in .NET Framework versione 2.0. |
/dll |
Produce un file DLL come output. |
/enc=file |
Crea delta di Modifica e continuazione a partire dal file di origine specificato. Questo argomento è esclusivamente per utilizzo accademico e non è supportato per un utilizzo commerciale. Questa è una nuova opzione di .NET Framework versione 2.0. |
/exe |
Produce un file eseguibile come output. Questa è l'impostazione predefinita. |
/flags=integer |
Imposta ImageFlags sul valore specificato da integer nell'intestazione di common language runtime. Se il comando IL .corflags è specificato 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. Questa è una nuova opzione di .NET Framework versione 2.0. |
/include=includePath |
Imposta un percorso per la ricerca di file inclusi con #include. Questa è una nuova opzione di .NET Framework versione 2.0. |
/itanium |
Specifica Intel Itanium come processore di destinazione. Se non è specificato il numero di bit dell'immagine, viene automaticamente impostato /pe64. Questa è una nuova opzione di .NET Framework versione 2.0. |
/key:Filechiave |
Compila nomefile con una firma sicura utilizzando la chiave privata contenuta in Filechiave. |
/key:@Originechiave |
Compila nomefile con una firma sicura utilizzando la chiave privata prodotta da Originechiave. |
/listing |
Produce un file di listato sull'output standard. Se si omette questa opzione, non verrà prodotto alcun file di listato. Questo parametro non è supportato in .NET Framework 2.0 o versione successiva. |
/mdv=versionString |
Imposta la stringa di versione dei metadati. Questa è una nuova opzione di .NET Framework versione 2.0. |
/msv=major.minor |
Imposta la versione del flusso di metadati, dove major e minor sono numeri interi. Questa è una nuova opzione di .NET Framework versione 2.0. |
/noautoinherit |
Disattiva l'ereditarietà predefinita da Object quando non è specificata alcuna classe base. Questa è una nuova opzione di .NET Framework versione 2.0. |
/nocorstub |
Disattiva la generazione dello stub CORExeMain. Questa è una nuova opzione di .NET Framework versione 2.0. |
/nologo |
Evita la visualizzazione del messaggio di avvio Microsoft. |
/output: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 Specificando /output:myfile.dll non viene 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. Questa è una nuova opzione di .NET Framework versione 2.0. |
/pe64 |
Crea un'immagine a 64 bit (PE32+). Se non è specificato il processore di destinazione, viene automaticamente impostato /itanium. Questa è una nuova opzione di .NET Framework versione 2.0. |
/pdb |
Crea un file PDB senza attivare la registrazione delle informazioni di debug. Questa è una nuova opzione di .NET Framework versione 2.0. |
/quiet |
Specifica la modalità non interattiva. Non visualizza informazioni sullo stato dell'assembly. |
/resource:file.res |
Include nel file EXE o DLL ottenuto il file di risorse specificato in formato *.res. È possibile specificare un unico file RES con l'opzione /resource. |
/stack=stackSize |
Imposta su stackSize il valore di SizeOfStackReserve nell'intestazione facoltativa NT. Questa è una nuova opzione di .NET Framework versione 2.0. |
/stripreloc |
Specifica che non sono necessarie rilocazioni di base. Questa è una nuova opzione di .NET Framework versione 2.0. |
/subsystem=integer |
Imposta il sottosistema sul valore specificato da integer nell'intestazione NT facoltativa. Se il comando IL .subsystem è specificato 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 è specificato il numero di bit dell'immagine, viene automaticamente impostato /pe64. Questa è una nuova opzione di .NET Framework versione 2.0. |
/? |
Visualizza la sintassi e le opzioni dei comandi dello strumento. |
Nota
Tutte le opzioni di Ilasm.exe sono soggette alla distinzione tre maiuscole e minuscole e vengono riconosciute dalle prime tre lettere. /lis, ad esempio, equivale a /listing e /res:myresfile.res equivale a /resource:myresfile.res. Le opzioni che specificano argomenti accettano i 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.
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.
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 finale o un carattere di fine riga.
È 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.
Nota
Attualmente non è possibile avvalersi di questa tecnica con file PE contenenti codice nativo incorporato, ad esempio file PE prodotti da Visual C++ .NET.
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.
Nota
Ildasm.exe opera solo su file su disco e non su file installati nella Global Assembly Cache.
Per ulteriori informazioni sulla grammatica di MSIL, vedere il file asmparse.grammar in Windows Software Development Kit (SDK).
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