Ildasm.exe (IL Disassembler)

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

Essa ferramenta é instalada automaticamente com o Visual Studio. Para executar a ferramenta, use o Prompt de Comando do Desenvolvedor do Visual Studio ou o PowerShell do Desenvolvedor do Visual Studio.

No prompt de comando, digite 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 opções adicionais a seguir 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 apenas para saída de arquivo ou de console.

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

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

Comentários

Ildasm.exe funciona apenas em arquivos PE no disco. Ele não funciona 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, durante a compilação do código em uma linguagem de programação que não dá suporte a todos os atributos de metadados do runtime. Depois de compilar o código e executar sua saída por meio de Ildasm.exe, o arquivo de texto IL resultante poderá ser editado manualmente para adicionar os atributos ausentes. Em seguida, é possível executar esse arquivo de texto por meio do IL Assembler para produzir um arquivo executável final.

É possível 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 nenhuma opção. No menu Arquivo, é possível navegar até o arquivo PE que você deseja carregar em Ildasm.exe. Para salvar os metadados e o código desmontado exibido para o PE selecionado, selecione o comando Despejo no menu Arquivo. Para salvar apenas o modo de exibição de árvore hierárquica, selecione o comando Despejar Modo de Exibição de Árvore no menu Arquivo. Para obter um guia detalhado para carregar um arquivo em Ildasm.exe e interpretar a saída, confira o Tutorial de Ildasm.exe, localizado na pasta Exemplos que acompanha o SDK do Windows.

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

É possível executar Ildasm.exe em um arquivo .exe ou .dll 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 versão

Do .NET Framework 4.5 em diante, o Ildasm.exe identifica um BLOB (objeto binário grande) de marshal não reconhecido exibindo o conteúdo binário bruto. Por exemplo, o código a seguir mostra como um BLOB de marshaling 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

Do .NET Framework 4.5 em diante, o Ildasm.exe exibe atributos aplicados a implementações de interface, conforme é mostrado no seguinte trecho da saída de Ildasm.exe:

.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 os metadados e o código desmontado do arquivo PE MyHello.exe serem exibidos na GUI padrão do Ildasm.exe.

ildasm myHello.exe

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

ildasm MyFile.exe /output:MyFile.il

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

ildasm MyFile.exe /text

Se o arquivo MyApp.exe contiver recursos gerenciados não gerenciados inseridos, 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 em MyFile.exe e exibe a saída na janela do console.

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

No exemplo anterior, talvez haja vários métodos chamados MyMethod com assinaturas diferentes. O comando a seguir desmonta o método de instância MyMethod 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 método static (método Shared 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 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 de 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. Por exemplo, se a classe MyNamespace.MyClass contiver uma classe aninhada chamada NestedClass, a classe aninhada será identificada da seguinte forma: class MyNamespace.MyClass/NestedClass.

Confira também

• Ferramentas
• Ilasm.exe (IL Assembler)
• Processo de execução gerenciada
• Shells de linha de comando do desenvolvedor