Condividi tramite


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

Vedere anche

Concetti

Compilazione in MSIL

Riferimenti

Strumenti di .NET Framework

Disassembler MSIL (Ildasm.exe)

Prompt dei comandi di SDK