Ildasm.exe (IL Disassembler)

IL Disassembler är ett kompletterande verktyg till IL Assembler (Ilasm.exe). Ildasm.exe tar en portabel körbar (PE)-fil som innehåller kod för mellanliggande språk (IL) och skapar en textfil som är lämplig som indata för Ilasm.exe.

Det här verktyget installeras automatiskt med Visual Studio. Om du vill köra verktyget använder du Visual Studio Developer Command Prompt eller Visual Studio Developer PowerShell.

Skriv följande vid kommandotolken:

Syntax

ildasm [options] [PEfilename] [options]

Parametrar

Följande alternativ är tillgängliga för filer som .exe, .dll, .obj, .lib och .winmd .

Följande ytterligare alternativ är tillgängliga för .exe-, .dll- och .winmd-filer .

Följande alternativ är giltiga för .exe-, .dll- och .winmd-filer endast för fil- eller konsolutdata.

Följande alternativ gäller endast för .exe-, .dll-, .obj-, .lib- och .winmd-filer för fil- eller konsolutdata.

Följande alternativ är giltiga för .lib-filer endast för fil- eller konsolutdata.

Kommentarer

Ildasm.exe fungerar bara på PE-filer på disk. Den fungerar inte på filer som är installerade i den globala sammansättningscacheminnet.

Textfilen som skapas av Ildasm.exe kan användas som indata till IL Assembler (Ilasm.exe). Detta är till exempel användbart när du kompilerar kod på ett programmeringsspråk som inte stöder alla körningsmetadataattribut. När koden har kompilerats och dess utdata har körts via Ildasm.exe kan den resulterande IL-textfilen redigeras för hand för att lägga till de attribut som saknas. Du kan sedan köra den här textfilen via IL Assembler för att skapa en slutlig körbar fil.

Du kan använda standard-GUI i IL Disassembler för att visa metadata och demonterad kod för alla befintliga PE-filer i en hierarkisk trädvy. Om du vill använda GUI skriver du ildasm på kommandoraden utan att ange PEfilename-argumentet eller några alternativ. Från menyn Arkiv kan du navigera till PE-filen som du vill läsa in i Ildasm.exe. Om du vill spara metadata och demonterad kod som visas för den valda PE:en väljer du kommandot Dump på menyn Arkiv . Om du bara vill spara den hierarkiska trädvyn väljer du kommandot Dump Treeview på menyn Arkiv . En detaljerad guide för att läsa in en fil i Ildasm.exe och tolka utdata finns i självstudien Ildasm.exe , som finns i mappen Exempel som levereras med Windows SDK.

Om du anger Ildasm.exe med ett PEfilename-argument som innehåller inbäddade resurser skapar verktyget flera utdatafiler: en textfil som innehåller IL-kod och för varje inbäddad hanterad resurs en .resources-fil som skapas med resursens namn från metadata. Om en ohanterad resurs är inbäddad i PEfilename skapas en .res-fil med det filnamn som anges för IL-utdata med alternativet /output .

Du kan köra Ildasm.exe över an.exe eller .dll fil för att avgöra om filen hanteras. Om filen inte hanteras visar verktyget ett meddelande om att filen inte har något giltigt gemensamt språkkörningshuvud och inte kan demonteras. Om filen hanteras körs verktyget.

Versionsinformation

Från och med .NET Framework 4.5 hanterar Ildasm.exe en okänd marskalksblob (binärt stort objekt) genom att visa det binära råinnehållet. Följande kod visar till exempel hur en blob för marskalk som genereras av ett C#-program visas:

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

Från och med .NET Framework 4.5 visar Ildasm.exe attribut som tillämpas på gränssnittsimplementeringar, enligt följande utdrag från Ildasm.exe utdata:

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

Exempel

Följande kommando gör att metadata och demonterad kod för PE-filen MyHello.exe visas i Ildasm.exe standard-GUI.

ildasm myHello.exe

Följande kommando demonterar filen MyFile.exe och lagrar den resulterande IL Assembler-texten i filen MyFile.il.

ildasm MyFile.exe /output:MyFile.il

Följande kommando demonterar filen MyFile.exe och visar den resulterande IL Assembler-texten i konsolfönstret.

ildasm MyFile.exe /text

Om filen MyApp.exe innehåller inbäddade hanterade och ohanterade resurser genererar följande kommando fyra filer: MyApp.il, MyApp.res, Icons.resources och Message.resources:

ildasm MyApp.exe /output:MyApp.il

Följande kommando demonterar metoden MyMethod i klassen MyClass i MyFile.exe och visar utdata till konsolfönstret.

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

I föregående exempel kan det finnas flera metoder med namnet MyMethod med olika signaturer. Följande kommando demonterar instansmetoden MyMethod med returtypen void och parametertyperna int32 och sträng.

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

Om du vill hämta en static metod (Shared -metod i Visual Basic) utelämnar du nyckelordet instance. Klasstyper som inte är primitiva typer som int32 och string måste innehålla namnområdet och som måste föregås av nyckelordet class. Externa typer måste föregås av biblioteksnamnet inom hakparenteser. Följande kommando demonterar en statisk metod med namnet MyMethod som har en parameter av typen AppDomain och har en returtyp av AppDomain.

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

En kapslad typ måste föregås av dess innehållande klass, avgränsad med ett snedstreck. Om MyNamespace.MyClass klassen till exempel innehåller en kapslad klass med namnet NestedClassidentifieras den kapslade klassen enligt följande: class MyNamespace.MyClass/NestedClass.

Se även

• Verktyg
• Ilasm.exe (IL Assembler)
• Hanterad körningsprocess
• Kommandoradsgränssnitt för utvecklare