Ildasm.exe (IL Desmontador)

O IL Disassembler é uma ferramenta complementar ao IL Assembler (Ilasm.exe). Ildasm.exe pega um arquivo executável portátil (PE) que contém código de linguagem intermediária (IL) e cria um arquivo de texto adequado como entrada para Ilasm.exe.

Esta ferramenta é instalada automaticamente com o Visual Studio. Para executar a ferramenta, use o Visual Studio Developer Command Prompt ou o Visual Studio Developer PowerShell.

Na linha de comandos, escreva o seguinte:

Sintaxe

ildasm [options] [PEfilename] [options]

Parâmetros

As opções a seguir estão disponíveis para arquivos .exe, .dll, .obj, .lib e .winmd .

As seguintes opções adicionais estão disponíveis para arquivos .exe, .dll e .winmd .

As opções a seguir são válidas para arquivos .exe, .dll e .winmd somente para saída de arquivo ou console.

As opções a seguir são válidas para arquivos .exe, .dll, .obj, .lib e .winmd somente para saída de arquivo ou console.

As opções a seguir são válidas apenas para arquivos .lib para saída de arquivo ou console.

Observações

Ildasm.exe só opera em arquivos PE no disco. Ele não opera em arquivos instalados no cache de assembly global.

O arquivo de texto produzido por Ildasm.exe pode ser usado como entrada para o IL Assembler (Ilasm.exe). Isso é útil, por exemplo, ao compilar código em uma linguagem de programação que não suporta todos os atributos de metadados de tempo de execução. Depois de compilar o código e executar sua saída através Ildasm.exe, o arquivo de texto IL resultante pode ser editado manualmente para adicionar os atributos ausentes. Em seguida, você pode executar esse arquivo de texto através do IL Assembler para produzir um arquivo executável final.

Você pode usar a GUI padrão no IL Disassembler para exibir os metadados e o código desmontado de qualquer arquivo PE existente em uma exibição de árvore hierárquica. Para usar a GUI, digite ildasm na linha de comando sem fornecer o argumento PEfilename ou quaisquer opções. No menu Arquivo , você pode navegar até o arquivo PE que deseja carregar no Ildasm.exe. Para salvar os metadados e o código desmontado exibidos para o PE selecionado, selecione o comando Despejar no menu Arquivo. Para salvar somente a exibição de árvore hierárquica, selecione o comando Dump Treeview no menu Arquivo . Para obter um guia detalhado sobre como carregar um arquivo no Ildasm.exe e interpretar a saída, consulte o Tutorial de Ildasm.exe , localizado na pasta Exemplos que acompanha o SDK do Windows.

Se você fornecer a Ildasm.exe um argumento PEfilename que contenha recursos incorporados, a ferramenta produzirá vários arquivos de saída: um arquivo de texto que contém código IL e, para cada recurso gerenciado incorporado, um arquivo .resources produzido usando o nome do recurso a partir de metadados. Se um recurso não gerenciado estiver incorporado em PEfilename, um arquivo .res será produzido usando o nome de arquivo especificado para saída IL pela opção /output .

Você pode executar Ildasm.exe sobre an.exe ou .dll arquivo para determinar se o arquivo é gerenciado. Se o arquivo não for gerenciado, a ferramenta exibirá uma mensagem informando que o arquivo não tem cabeçalho de Common Language Runtime válido e não pode ser desmontado. Se o arquivo for gerenciado, a ferramenta será executada com êxito.

Informações sobre a Versão

A partir do .NET Framework 4.5, Ildasm.exe manipula um BLOB marshal não reconhecido (objeto binário grande) exibindo o conteúdo binário bruto. Por exemplo, o código a seguir mostra como um BLOB marshal gerado por um programa C# é exibido:

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 partir do .NET Framework 4.5, Ildasm.exe exibe atributos que são aplicados a implementações de interface, conforme mostrado no seguinte trecho de Ildasm.exe saída:

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

Exemplos

O comando a seguir faz com que os metadados e o código desmontado do arquivo MyHello.exe PE sejam exibidos na GUI padrão do Ildasm.exe .

ildasm myHello.exe

O comando a seguir desmonta o arquivo MyFile.exe e armazena o texto resultante do IL Assembler na MyFile.il do arquivo.

ildasm MyFile.exe /output:MyFile.il

O comando a seguir desmonta o arquivo MyFile.exe e exibe o texto resultante do IL Assembler na janela do console.

ildasm MyFile.exe /text

Se o arquivo MyApp.exe contiver recursos gerenciados e não gerenciados incorporados, o comando a seguir produzirá quatro arquivos: MyApp.il, MyApp.res, Icons.resources e Message.resources:

ildasm MyApp.exe /output:MyApp.il

O comando a seguir desmonta o método MyMethod dentro da classe MyClass in MyFile.exe e exibe a saída para a janela do console.

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

No exemplo anterior, poderia haver vários métodos nomeados MyMethod com assinaturas diferentes. O comando a seguir desmonta o método MyMethod de instância com o tipo de retorno de void e os tipos de parâmetro int32 e string.

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

Para recuperar um static método (Shared método no Visual Basic), omita a palavra-chave instance. Tipos de classe que não são tipos primitivos como int32 e string devem incluir o namespace e devem ser precedidos pela palavra-chave class. Os tipos externos devem ser precedidos pelo nome da biblioteca entre colchetes. O comando a seguir desmonta um método estático chamado MyMethod que tem um parâmetro do tipo AppDomain e tem um tipo de retorno de AppDomain.

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

Um tipo aninhado deve ser precedido por sua classe de contenção, delimitada por uma barra para frente. Por exemplo, se a MyNamespace.MyClass classe contiver uma classe aninhada chamada NestedClass, a classe aninhada será identificada da seguinte forma: class MyNamespace.MyClass/NestedClass.

Consulte também

• Ferramentas
• Ilasm.exe (IL Montador)
• Processo de Execução Gerenciado
• Shells de linha de comando do desenvolvedor