Ildasm.exe (IL Disassembler)

Der IL-Disassembler ist ein ergänzendes Tool zum IL-Assembler (Ilasm.exe). Ildasm.exe erfasst eine portierbare ausführbare Datei (Portable Executable, PE) mit IL-Code (Intermediate Language) und erstellt eine Textdatei, die in Ilasm.exe eingegeben werden kann.

Dieses Tool wird automatisch mit Visual Studio installiert. Um das Tool auszuführen, verwenden Sie die Developer-Eingabeaufforderung von Visual Studio oder Visual Studio Developer PowerShell.

Geben Sie an der Eingabeaufforderung Folgendes ein:

Syntax

ildasm [options] [PEfilename] [options]

Parameter

Für Dateien mit den Erweiterungen .exe, .dll, .obj, .lib und .winmd stehen die folgenden Optionen zur Verfügung.

Für Dateien mit den Erweiterungen .exe, .dll und .winmd stehen die folgenden zusätzlichen Optionen zur Verfügung.

Die folgenden Optionen gelten nur für Dateien mit den Erweiterungen .exe, .dll und .winmd bei der Ausgabe in einer Datei oder der Konsole.

Die folgenden Optionen gelten nur für Dateien mit den Erweiterungen .exe, .dll, .obj, .lib und .winmd bei der Ausgabe in einer Datei oder der Konsole.

Die folgenden Optionen gelten nur für LIB-Dateien bei der Ausgabe in eine Datei oder auf der Konsole.

Hinweise

Ildasm.exe funktioniert nur bei PE-Dateien auf der Festplatte. Bei Dateien, die im globalen Assemblycache installiert sind, funktioniert dieses Tool nicht.

Die von Ildasm.exe erstellte Textdatei kann als Eingabe für den IL-Assembler (Ilasm.exe) verwendet werden. Dies ist zum Beispiel nützlich, wenn Code in einer Programmiersprache programmiert werde soll, die nicht alle Attribute der Metadaten der Laufzeit unterstützt. Nachdem der Code kompiliert und seine Ausgabe über Ilasm.exe verarbeitet wurde, kann die resultierende IL-Textdatei manuell bearbeitet werden, um die fehlenden Attribute hinzuzufügen. Sie können diese Textdatei anschließend durch den IL-Assembler ausführen, um eine endgültige ausführbare Datei zu erstellen.

In der als Standard festgelegten grafischen Benutzeroberfläche des IL-Disassemblers können Sie sich die Metadaten und den disassemblierten Code aller vorhandenen PE-Dateien als hierarchische Struktur anzeigen lassen. Geben Sie zum Aufrufen der Benutzeroberfläche an der Befehlszeile ildasm ein, ohne dabei das PEfilename-Argument oder Optionen anzugeben. Im Menü Datei können Sie zu der PE-Datei navigieren, die Sie in Ildasm.exe laden möchten. Um die Metadaten und den disassemblierten Code zu speichern, die für die ausgewählte PE angezeigt werden, wählen Sie im Menü Datei den Befehl Sichern aus. Wenn Sie nur die angezeigte hierarchische Struktur speichern möchten, wählen Sie im Menü Datei den Befehl Strukturansicht sichern aus. Ausführliche Anleitungen zum Laden einer Datei in Ildasm.exe und zum Interpretieren der Ausgabe finden Sie im Tutorial für Ildasm.exe. Dies ist im Lieferumfang des Windows SDK enthalten und befindet sich im Ordner „Samples“.

Wenn Sie Ildasm.exe mit dem PEfilename-Argument angeben, das eingebettete Ressourcen enthält, erstellt das Tool mehrere Ausgabedateien: eine Textdatei mit IL-Code und für jede eingebettete verwaltete Ressource eine RESOURCES-Datei, die unter Verwendung des Ressourcennamens aus Metadaten erstellt wird. Wenn in PEfilename eine nicht verwaltete Ressource eingebettet ist, wird eine RES-Datei unter Verwendung des Dateinamens erstellt, der durch die Option /output für die IL-Ausgabe angegeben wird.

Sie können Ildasm.exe für eine EXE- oder DLL-Datei ausführen, um festzustellen, ob die Datei verwaltet ist. Wenn die Datei nicht verwaltet ist, zeigt das Tool eine Meldung an, dass die Datei keinen gültigen Common Language Runtime-Header enthält und nicht disassembliert werden kann. Bei einer verwalteten Datei wird das Tool erfolgreich ausgeführt.

Versionsinformationen

Ab .NET Framework 4.5 verarbeitet Ildasm.exe ein unbekanntes Marshall-BLOB (Binary Large Object), indem der unformatierte binäre Inhalt angezeigt wird. Beispielsweise wird im folgenden Code veranschaulicht, wie ein BLOB-Marshall, der von einem C#-Programm generiert wird, angezeigt wird:

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

Ab .NET Framework 4.5 zeigt Ildasm.exe Attribute an, die auf Schnittstellenimplementierungen angewendet werden, wie im folgenden Auszug der Ausgabe von Ildasm.exe zu sehen:

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

Beispiele

Mit dem folgenden Befehl werden die Metadaten und der disassemblierte Code für die PE-Datei MyHello.exe in der als Standard festgelegten grafischen Benutzeroberfläche von Ildasm.exe angezeigt.

ildasm myHello.exe

Der folgende Befehl disassembliert die Datei MyFile.exe und speichert den erstellten IL-Assembler-Text in der Datei MyFile.il.

ildasm MyFile.exe /output:MyFile.il

Der folgende Befehl disassembliert die Datei MyFile.exe und zeigt den erstellten IL-Assembler-Text im Konsolenfenster an.

ildasm MyFile.exe /text

Wenn die Datei MyApp.exe eingebettete verwaltete und nicht verwaltete Ressourcen enthält, erstellt der folgende Befehl diese vier Dateien: MyApp.il, MyApp.res, Icons.resources und Message.resources:

ildasm MyApp.exe /output:MyApp.il

Der folgende Befehl disassembliert die MyMethod-Methode in der MyClass-Klasse in MyFile.exeund zeigt die Ausgabe im Konsolenfenster an.

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

Im vorigen Beispiel waren mehrere Methoden mit dem Namen MyMethod mit unterschiedlichen Signaturen möglich. Der folgende Befehl disassembliert die MyMethod-Instanzmethode mit dem Rückgabetyp void und den Parametertypen int32 und string.

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

Um eine static-Methode (Shared-Methode in Visual Basic) abzurufen, lassen Sie das Schlüsselwort instance weg. Klassentypen, die keine Typen sind, beispielsweise int32 und string, müssen den Namespace enthalten, und ihnen muss das Schlüsselwort class vorangestellt sein. Externen Typen muss der Bibliotheksname in eckigen Klammern vorangestellt werden. Der folgende Befehl disassembliert eine statische Methode namens MyMethod, die einen Parameter vom Typ AppDomain und den Rückgabetyp AppDomain besitzt.

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

Bei einem geschachtelten Typ muss die Klasse, in der er enthalten ist, vorangestellt sein, begrenzt von einem Schrägstrich. Wenn die MyNamespace.MyClass-Klasse z. B. eine geschachtelte Klasse mit dem Namen NestedClass enthält, wird die geschachtelte Klasse folgendermaßen identifiziert: class MyNamespace.MyClass/NestedClass.

Siehe auch

• Extras
• Ilasm.exe (IL-Assembler)
• Der verwaltete Ausführungsprozess
• Befehlszeilenshells für Entwickler