MSIL Assembler-Tool (Ilasm.exe)

Das MSIL Assembler-Tool generiert eine PE-Datei (Portable Executable) aus MSIL (Microsoft Intermediate Language). (Weitere Informationen zu MSIL finden Sie unter Kompilieren in MSIL). Sie können die erstellte ausführbare Datei mit MSIL und den erforderlichen Metadaten ausführen, um zu ermitteln, ob die Ausführung von MSIL Ihren Erwartungen entspricht.

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

Parameter

Hinweise

Das MSIL Assembler-Tool unterstützt Anbieter von Tools beim Entwerfen und Implementieren von MSIL-Generatoren. Durch die Verwendung von Ilasm.exe können sich Entwickler von Tools und Compilern auf die Generierung von MSIL und Metadaten konzentrieren, da die Ausgabe von MSIL im PE-Dateiformat keine Probleme bereitet.

Ähnlich wie andere Compiler, die die Laufzeit ansprechen (z. B. C# und Visual Basic), erstellt Ilasm.exe keine Objektzwischendateien und benötigt keine Verknüpfungsstufe zum Erstellen einer PE-Datei.

Das MSIL Assembler-Tool kann alle vorhandenen Metadaten und MSIL-Features der Programmiersprachen ausdrücken, die die Laufzeit ansprechen. Dadurch kann verwalteter Code, der in einer dieser Programmiersprachen geschrieben wurde, im MSIL Assembler-Tool adäquat ausgedrückt und mit Ilasm.exe kompiliert werden.

Sie können Ilasm.exe zusammen mit dem zugehörigen Tool Ildasm.exe verwenden. Ildasm.exe erfasst eine PE-Datei mit MSIL-Code und erstellt eine Textdatei, die in Ilasm.exe eingegeben werden kann. Dies empfiehlt sich beispielsweise beim Kompilieren von Code in einer Programmiersprache, die nicht alle Attribute der Metadaten der Laufzeit unterstützt. Nach dem Kompilieren des Codes und dem Ausführen seiner Ausgabe durch Ildasm.exe kann die erstellte MSIL-Textdatei manuell bearbeitet werden, um die fehlenden Attribute hinzuzufügen. Sie können diese Textdatei anschließend durch Ilasm.exe ausführen, um eine endgültige ausführbare Datei zu erstellen.

Mit diesem Verfahren können Sie auch eine einzelne PE-Datei aus mehreren PE-Dateien erstellen, die ursprünglich von anderen Compilern generiert wurden.

Um bei der kombinierten Verwendung von Ildasm.exe und Ilasm.exe größtmögliche Genauigkeit zu gewährleisten, führt der Assembler einige einfache Optimierungen nicht durch. Es wird nicht hergeleitet, ob die Kurz- oder Langform von Anweisungen verwendet werden soll. Das Tool bestimmt z. B. nicht, ob eine kurze Codierung durch eine lange Codierung ersetzt werden kann, die Sie in den MSIL-Quellen verfasst haben oder die von einem anderen Compiler ausgegeben wurde. Wenn Sie die kurze Codierung wünschen, müssen Sie dies explizit schreiben. Der Assembler führt jedoch eine Überprüfung auf ungültige Bedingungen durch, sofern dies möglich ist.

Beispiele

Der folgende Befehl assembliert die MSIL-Datei myTestFile.il und erstellt die ausführbare Datei myTestFile.exe..

ilasm myTestFile

Der folgende Befehl assembliert die MSIL-Datei myTestFile.il und erstellt die DLL-Datei myTestFile.dll.

ilasm myTestFile /dll 

Der folgende Befehl assembliert die MSIL-Datei myTestFile.il und erstellt die DLL-Datei myNewTestFile.dll.

ilasm myTestFile /dll /output:myNewTestFile.dll

Im folgenden Codebeispiel wird eine sehr einfache Anwendung veranschaulicht, durch die "Hello World!" auf der Konsole ausgegeben wird. Sie können diesen Code kompilieren und dann das Tool Ildasm.exe verwenden, um eine MSIL-Datei zu generieren.

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

Das folgende MSIL-Codebeispiel entspricht dem vorherigen C#-Codebeispiel. Sie können diesen Code mit dem Tool MSIL Assembler-Tool (Ilasm.exe) in eine Assembly kompilieren. Sowohl durch das MSIL- als auch durch das C#-Codebeispiel wird "Hello World!" auf der Konsole ausgegeben.

// 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

Siehe auch

Referenz

.NET Framework-Tools
MSIL Disassembler-Tool (Ildasm.exe)
SDK-Eingabeaufforderung

Konzepte

Kompilieren in MSIL