Ildasm.exe (Disassembler IL)

Il disassembler IL è uno strumento complementare all'assembler IL (Ilasm.exe). Ildasm.exe accetta un file eseguibile di tipo PE contenente codice di linguaggio intermedio (IL) e crea un file di testo adatto come input per Ilasm.exe.

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

ildasm [options] [PEfilename] [options]

Parametri

Le opzioni che seguono sono disponibili per i file .exe, .dll, .obj, .lib e .winmd.

Le altre opzioni che seguono sono disponibili per i file .exe, .dll e .winmd.

Le opzioni che seguono sono valide per i file .exe, .dll e .winmd solo per l'output su file o su console.

Le opzioni che seguono sono valide per i file .exe, .dll, .obj, .lib e .winmd solo per l'output su file o console.

Le opzioni che seguono sono valide per i file .lib solo per l'output su file o su console.

Osservazioni:

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

Il file di testo prodotto da Ildasm.exe può essere utilizzato come input per l'assembler IL(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 l'assembler IL per produrre un file eseguibile finale.

È possibile utilizzare la GUI predefinita del disassembler IL per visualizzare i metadati e il codice disassemblato di qualsiasi file PE esistente in una visualizzazione albero di tipo gerarchico. Per usare la GUI, digitare ildasm alla riga di comando senza specificare l'argomento PEfilename né alcuna opzione. Dal menu File è possibile passare al file di tipo PE che si vuole caricare in Ildasm.exe. Per salvare i metadati e il codice disassemblato visualizzati per il file PE selezionato, scegliere il comando Dump dal menu File. Per salvare solo la visualizzazione albero di tipo gerarchico, scegliere Esegui il dump di TreeView dal menu File. Per una guida dettagliata sul caricamento di un file in Ildasm.exe e sull'interpretazione dell'output, vedere l'esercitazione di Ildasm.exe, contenuta nella cartella Samples inclusa in Windows SDK.

Se si specifica per Ildasm.exe un argomento PEfilename che contiene risorse incorporate, lo strumento produrrà più file di output: un file di testo contenente codice IL e, per ogni risorsa gestita incorporata, un file con estensione resources prodotto usando il nome della risorsa dai metadati. Se in PEfilename è incorporata una risorsa non gestita, verrà prodotto un file con estensione res usando il nome file specificato dall'opzione /output per l'output IL.

Per determinare se il file è gestito è possibile eseguire Ildasm.exe su un file .exe o .dll . Se il file non è gestito, verrà visualizzato un messaggio che comunica che il file non include alcuna intestazione Common Language Runtime valida e non può essere disassemblato. Se invece il file è gestito, l'operazione verrà eseguita correttamente.

Informazioni sulla versione

A partire da .NET Framework 4.5, Ildasm.exe gestisce un BLOB di marshalling non riconosciuto (oggetto binario di grandi dimensioni) visualizzando il contenuto binario non elaborato. Ad esempio, il codice seguente mostra come viene visualizzato un BLOB di marshalling generato da un programma C#:

public void Test([MarshalAs((short)70)] int test) { }

// IL from Ildasm.exe output
.method public hidebysig instance void Test(int32  marshal({ 46 }) test) cil managed

A partire da .NET Framework 4.5, Ildasm.exe visualizza gli attributi applicati alle implementazioni dell'interfaccia, come illustrato nell'estratto seguente di Ildasm.exe output:

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

Esempi

Il comando che segue visualizza i metadati e il codice disassemblato del file di tipo PE MyHello.exe nella GUI predefinita di Ildasm.exe.

ildasm myHello.exe

Il comando che segue disassembla il file MyFile.exe e archivia nel file MyFile.il il testo ottenuto per l'assembler IL.

ildasm MyFile.exe /output:MyFile.il

Il comando che segue disassembla il file MyFile.exe e visualizza nella finestra della console il testo ottenuto per l'assembler IL.

ildasm MyFile.exe /text

Se il file MyApp.exe contiene risorse incorporate gestite e non gestite, il comando seguente produrrà quattro file: MyApp.il, MyApp.res, Icons.resources e Message.resources:

ildasm MyApp.exe /output:MyApp.il

Il comando seguente disassembla il metodo MyMethod della classe MyClass in MyFile.exe e visualizza l'output nella finestra della console.

ildasm /item:MyClass::MyMethod MyFile.exe /text

Nell'esempio precedente potrebbero essere presenti più metodi denominati MyMethod con firme diverse. Il comando seguente disassembla il metodo di istanza MyMethod con il tipo restituito void e i tipi di parametri int32 e string.

ildasm /item:"MyClass::MyMethod(instance void(int32,string)" MyFile.exe /text

Per recuperare un metodo static (metodoShared in Visual Basic), omettere la parola chiave instance. I tipi di classe che non sono tipi primitivi come int32 e string devono includere lo spazio dei nomi e devono essere preceduti dalla parola chiave class. I tipi esterni devono essere preceduti dal nome della libreria tra parentesi quadre. Il comando che segue disassembla un metodo statico denominato MyMethod che ha un parametro di tipo AppDomain e un tipo restituito di AppDomain.

ildasm /item:"MyClass::MyMethod(class [mscorlib]System.AppDomain(class [mscorlib]System.AppDomain)" MyFile.exe /text

Un tipo annidato deve essere preceduto dalla classe in cui è contenuto, delimitata da una barra. Se ad esempio nella classe MyNamespace.MyClass è contenuta una classe annidata denominata NestedClass, la classe annidata viene identificata come segue: class MyNamespace.MyClass/NestedClass.

Vedi anche

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