Ildasm.exe (IL Disassembler)

IL Disassembler je doprovodný nástroj k assembleru IL (Ilasm.exe). Ildasm.exe vezme přenosný spustitelný soubor (PE), který obsahuje kód IL (Intermediate Language) a vytvoří textový soubor vhodný jako vstup pro Ilasm.exe.

Tento nástroj je automaticky nainstalován se sadou Visual Studio. Ke spuštění nástroje použijte Visual Studio Developer Command Prompt nebo Visual Studio Developer PowerShell.

Na příkazovém řádku zadejte následující:

Syntaxe

ildasm [options] [PEfilename] [options]

Parametry

Pro soubory .exe, .dll, .obj, .lib a .winmd jsou k dispozici následující možnosti.

Pro soubory .exe, .dll a .winmd jsou k dispozici následující další možnosti.

Následující možnosti jsou platné pouze pro soubory .exe, .dll a .winmd pro výstup souboru nebo konzoly.

Následující možnosti jsou platné jenom pro soubory .exe, .dll, .obj, .lib a .winmd .

Následující možnosti jsou platné pouze pro soubory .lib pro soubor nebo výstup konzoly.

Poznámky

Ildasm.exe funguje jenom se soubory PE na disku. Nepracuje se soubory nainstalovanými do globální mezipaměti sestavení.

Textový soubor vytvořený Ildasm.exe lze použít jako vstup do assembleru IL (Ilasm.exe). Toho lze využít například při kompilování kódu v programovacím jazyce, který nepodporuje všechny atributy modulu runtime. Po kompilaci kódu a spuštění výstupu prostřednictvím Ildasm.exe můžete výsledný textový soubor IL ručně upravit a přidat chybějící atributy. Poté lze tento textový soubor zpracovat nástrojem IL Assembler a vytvořit konečný spustitelný soubor.

Chcete-li zobrazit metadata a zpětně přeložený kód libovolného existujícího souboru PE v hierarchickém stromovém zobrazení, lze použít výchozí grafické uživatelské rozhraní nástroje IL Disassembler. Pokud chcete použít grafické uživatelské rozhraní, zadejte na příkazovém řádku ildasm bez zadání argumentu PEfilename nebo jakýchkoli možností. V nabídce Soubor můžete přejít do souboru PE, který chcete načíst do Ildasm.exe. Chcete-li uložit metadata a rozebrat kód zobrazený pro vybrané prostředí PE, vyberte příkaz Výpis paměti z nabídky Soubor . Chcete-li uložit pouze hierarchické stromové zobrazení, vyberte příkaz Dump Treeview z nabídky Soubor . Podrobný průvodce načtením souboru do Ildasm.exe a interpretací výstupu najdete v kurzu Ildasm.exe , který se nachází ve složce Samples, která je součástí sady Windows SDK.

Pokud zadáte Ildasm.exe s argumentem PEfilename , který obsahuje vložené prostředky, nástroj vytvoří více výstupních souborů: textový soubor obsahující kód IL a pro každý vložený spravovaný prostředek soubor .resources vytvořený pomocí názvu prostředku z metadat. Pokud je nespravovaný prostředek vložen do souboru PEfilename, vytvoří se soubor .res pomocí názvu souboru určeného pro výstup IL pomocí možnosti /output .

Můžete spustit Ildasm.exe přes an.exe nebo .dll soubor a určit, jestli je soubor spravovaný. Není-li soubor spravovaný, nástroj zobrazí zprávu oznamující, že soubor neobsahuje žádnou platnou hlavičku modulu CLR a nelze jej zpětně přeložit. Pokud soubor spravovaný je, nástroj se úspěšně spustí.

Informace o verzi

Počínaje rozhraním .NET Framework 4.5 Ildasm.exe zpracovává nerozpoznaný objekt BLOB zařazování (binární velký objekt) zobrazením nezpracovaného binárního obsahu. Následující kód například ukazuje, jak je zobrazen zařazovací objekt BLOB vygenerovaný programem jazyka 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

Počínaje rozhraním .NET Framework 4.5 Ildasm.exe zobrazí atributy použité pro implementace rozhraní, jak je znázorněno v následujícím výňatku z Ildasm.exe výstupu:

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

Příklady

Následující příkaz způsobí, že se metadata a rozložený kód souboru MyHello.exe PE zobrazí v Ildasm.exe výchozím grafickém uživatelském rozhraní.

ildasm myHello.exe

Následující příkaz soubor rozebere MyFile.exe a uloží výsledný text IL Assembler do souboru MyFile.il.

ildasm MyFile.exe /output:MyFile.il

Následující příkaz soubor MyFile.exe rozebere a zobrazí výsledný text jazyka IL Assembler do okna konzoly.

ildasm MyFile.exe /text

Pokud soubor MyApp.exe obsahuje vložené spravované a nespravované prostředky, vytvoří následující příkaz čtyři soubory: MyApp.il, MyApp.res, Icons.resources a Message.resources:

ildasm MyApp.exe /output:MyApp.il

Následující příkaz rozebere metodu MyMethod v rámci třídy MyClass MyFile.exe a zobrazí výstup do okna konzoly.

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

V předchozím příkladu může existovat několik metod pojmenovaných MyMethod s různými podpisy. Následující příkaz rozebere metodu MyMethod instance s návratovým typem void a typy parametrů int32 a string.

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

Chcete-li načíst metodu static (Shared metoda v jazyce Visual Basic), vynecháte klíčové slovo instance. Typy tříd, které nejsou primitivními typy jako int32 a string musí obsahovat obor názvů a musí předcházet klíčové slovo class. Před externími typy musí být uveden název knihovny v hranatých závorkách. Následující příkaz rozebere statickou metodu s názvem MyMethod , která má jeden parametr typu AppDomain a má návratový AppDomaintyp .

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

Před vnořeným typem musí být uvedena třída, která jej obsahuje, oddělená lomítkem. Pokud například MyNamespace.MyClass třída obsahuje vnořenou třídu s názvem NestedClass, vnořená třída je identifikována takto: class MyNamespace.MyClass/NestedClass.

Viz také

• Nástroje
• Ilasm.exe (IL Assembler)
• Proces spravovaného spuštění
• Prostředí příkazového řádku pro vývojáře