Desassemblador do MSIL (ILDASM.exe)

O Desassemblador do MSIL é uma ferramenta complementar para o Assembler MSIL (Ilasm.exe). Um arquivo executável portável (PE) que contém o código Microsoft intermediate linguagem (MSIL) e cria um arquivo de texto adequado sistema autônomo entrado para Ilasm.exe se obtém ILDASM.exe.

ildasm [options] [PEfilename] [options]

Parâmetros

As seguintes opções estão disponível para o .exe, .dll, .obj e .lib arquivos.

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

As seguintes opções estão válido para arquivos .exe e .dll para arquivo ou somente de saída do console.

Opção	Descrição
/All	Especifica uma combinação do /header, /bytes, /stats, /classlist, e /tokens opções. Observação: Nas versões do .NET estrutura 1.0 e 1.1, especifica uma combinação da /cabeçalho, /bytes, and /tokens opções.
/classlist	Inclui uma lista de classes definidas no módulo. Novo no .NET estrutura versão 2.0.
/forward	Usos encaminham declaração de classe. Novo no .NET estrutura versão 2.0.
/cabeçalho	Inclui informações do arquivo de cabeçalho na saída.
/item:class[::member[(sig]]	Desmonta a seguir dependendo o argumento fornecido: Desmonta o especificadoclasse. Desmonta o especificadomember da classe. Desmonta o memberda classe com a assinatura especificada SIG. O formato de SIG is: [instance] returnType(parameterType1, parameterType2, …, parameterTypeN) Observação:   Nas versões do .NET estrutura 1.0 e 1.1, sig deve ser seguido por um parêntese de fechamento: (sig). Na versão 2.0 deve ser omitido o parêntese de fechamento: (sig.
/noil	Suprime a saída de código do assembly MSIL.
/stats	Inclui estatísticas na imagem. Novo no .NET estrutura versão 2.0.
/typelist	Produz a lista completa de tipos, para preservar o tipo de pedidos em uma viagem de ida e volta. Novo no .NET estrutura versão 2.0.
/Unicode	Usa codificação Unicode para saída.
/UTF8	Usa a codificação UTF-8 para a saída. ANSI é o padrão.

As seguintes opções estão válido para arquivos .exe, .dll, .obj e .lib para arquivo ou somente de saída do console.

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

Observação:

Todas as opções para ILDASM.exe são sem diferenciação de maiúsculas e minúsculas e é reconhecido pelas três primeiras letras. Por exemplo, /quo é equivalente a /quoteallnames. Opções que especificam argumentos aceitam qualquer um dos dois-pontos (:) ou com um sinal de igual (=) sistema autônomo separador entre a opção e o argumento. Por exemplo, /Output:nome do arquivo de é equivalente a / saída =nome do arquivo de .

Comentários

ILDASM.exe só funciona em arquivos PE no disco. Ele não opera em arquivos instalados no cache global de assemblies.

O arquivo de texto produzido pela ILDASM.exe pode ser usado sistema autônomo entrada para o Assembler MSIL (Ilasm.exe). Isso é útil, por exemplo, durante a compilação de código em uma linguagem de programação que não oferece suporte a todos os atributos de metadados em tempo de execução. Após compilar o código e executar sua saída por meio de ILDASM.exe, o arquivo de texto MSIL resultante pode ser editados manualmente para adicionar os atributos ausentes. É possível executar este arquivo de texto por meio de Assembler MSIL para produzir um arquivo executável final.

Observação:
Atualmente, não é possível usar essa técnica com arquivos PE que contêm código nativo incorporado (por exemplo, arquivos PE produzidos pelo Visual C++).

Você pode usar o padrão GUI no Desassemblador do MSIL para exibir os metadados e o código desmontado dos arquivos PE existentes em um modo de exibição de árvore hierárquica. Para usar a interface gráfica do usuário, digite ILDASM na linha de comando sem fornecer a PEfilename argumento ou todas as opções. From a Arquivo menu, você pode navegar para o arquivo PE que você deseja carregar em ILDASM.exe. Para salvar os metadados e o código desmontado exibido para o PE selecionado, selecionar o Despejo comando a Arquivo menu. Para salvar somente a exibição em árvore hierárquica, selecionar o Despejar TreeView comando a Arquivo menu. Para obter um guia detalhado para carregar um arquivo em ILDASM.exe e interpretar a saída, consulte o tutorial ILDASM.exe, localizado na pasta Exemplos que acompanha o Windows Software Development Kit (SDK).

Se você fornecer um ILDASM.exePEfilename argumento que contém recursos incorporados, a ferramenta produz vários arquivos de saída: um arquivo de texto que contém código MSIL e, para cada recurso gerenciado, um arquivo .Recursos produzido com o nome do recurso de metadados incorporados. Se um recurso não gerenciado é incorporado em PEfilename, um arquivo .res é produzido com o nome de arquivo especificado para a saída do MSIL pela /Output option*.*

Observação:
ILDASM.exe mostra somente descrições de metadados para arquivos de entrada .obj e .lib. Código MSIL para esses tipos de arquivo não está desmontado.

Você pode executar o ILDASM.exe sobre arquivo an.exe ou .dll para determinar se o arquivo é gerenciado. Se o arquivo não for gerenciado, a ferramenta exibe uma mensagem informando que o arquivo não tem nenhum cabeçalho de tempo de execução comum linguagem válido e não pode ser desmontado. Se o arquivo for gerenciado, a ferramenta é executada com êxito.

Exemplos

O comando a seguir faz com que os metadados e desmontado código para o do arquivo PE MyHello.exe Para exibir no padrão ILDASM.exe GUI.

ildasm myHello.exe

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

ildasm MyFile.exe /output:MyFile.il

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

ildasm MyFile.exe /text

Se o arquivo MyApp.exe contém recursos gerenciado e incorporados, o comando a seguir produz 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, pode haver 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 void o parâmetro e de tiposInt32 and seqüência de caracteres.

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

Observação:
No .NET estrutura versões 1.0 e 1.1, o parêntese esquerdo que segue o método nome deve ser equilibrada por um parêntese direito após a assinatura: MyMethod(instance void(int32)). O parêntese de fechamento deve ser omitido no .NET estrutura versão 2.0: MyMethod(instance void(int32).

Para recuperar um static método)Shared método no Visual Basic), omitir a palavra-chave instance. Tipos de classe que não são tipos primitivos, como int32 e string deve incluir o espaço para nome e deve ser precedido pela palavra-chave class. Tipos externos devem ser precedidos pelo nome da biblioteca entre colchetes. O comando a seguir desmonta um método estático denominado MyMethod que tem um parâmetro de tipo AppDomain e tem um tipo de retorno 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, delimitada por uma barra / / invertida. Por exemplo, se o MyNamespace.MyClass classe contém uma classe aninhada chamada NestedClass, a classe aninhada é identificada sistema autônomo segue: class MyNamespace.MyClass/NestedClass.

Consulte também

Conceitos

Compilação para MSIL

Referência

Ferramentas.NET Framework

Assembler MSIL (Ilasm.exe)

Prompt de comando SDK