Ilasm. exe (Assembler MSIL)

O Assembler MSIL gera um arquivo de executável portável (PE) da Microsoft intermediate language (MSIL). (Para obter mais informações sobre o MSIL, consulte Processo de Execução Gerenciada.) Você pode executar o executável resultante, que contém o MSIL e os metadados necessários, para determinar se o MSIL executa como esperado.

O Assembler MSIL é instalado automaticamente com o Visual Studio. Para iniciar o Assembler MSIL, use o Prompt de comando Visual Studio. No prompt de comando, digite o seguinte:

ilasm [options] filename [[options]filename...]

Parâmetros

Comentários

O Assembler MSIL ajuda o design da ferramenta de fornecedores e implementar os geradores MSIL. Usando o Ilasm. exe, os desenvolvedores da ferramenta e o compilador podem se concentrar na geração de metadados e MSIL sem se preocupar com a emissão de MSIL no formato de arquivo PE.

Semelhante a outros compiladores que visa o runtime, como, por exemplo, C# e Visual Basic, Ilasm. exe não produza arquivos intermediários do objeto e não requer um estágio de vinculação para formar um arquivo PE.

O Assembler MSIL pode expressar todos os metadados existentes e os recursos MSIL das linguagens de programação que destino o tempo de execução. Isso permite que o código gerenciado escrito em qualquer uma dessas linguagens de programação a ser expressa adequadamente em Assembler MSIL e compilados com Ilasm. exe.

Você pode usar Ilasm. exe em conjunto com sua ferramenta complementar, Ildasm. exe. Ildasm. exe leva de um arquivo PE que contém código MSIL e cria um arquivo de texto adequado como entrado para Ilasm. exe. Isso é útil, por exemplo, ao compilar o código em uma linguagem de programação não oferece suporte a todos os atributos de metadados de tempo de execução. Após compilar o código e executar a 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 o arquivo de texto por meio de Ilasm. exe para produzir um arquivo executável final.

Você também pode usar essa técnica para produzir um único arquivo PE a partir de vários arquivos de PE originalmente gerados por compiladores diferentes.

Para tornar esse uso combinado do Ildasm. exe e Ilasm. exe tão precisa quanto possível, o montador não realiza algumas otimizações simples — não deduzir se usar formulários de curtos ou longos de instruções. Por exemplo, a ferramenta não tenta determinar se poderia substituir uma codificação curto para um nome longo, talvez você tenha escrito em suas fontes MSIL (ou que pode ser emitido pelo compilador outro). Se desejar que a codificação curto, escreva explicitamente desse formulário. No entanto, o montador verificar as condições de fora do intervalo onde isso é possível.

Para obter mais informações sobre a gramática de MSIL, consulte o arquivo asmparse.grammar do Windows Software Development Kit (SDK).

Exemplos

O seguinte comando monta o arquivo MSIL myTestFile.il e produz o executável myTestFile.exe.

ilasm myTestFile

O seguinte comando monta o arquivo MSIL myTestFile.il e produz um arquivo. dll myTestFile.dll.

ilasm myTestFile /dll 

O seguinte comando monta o arquivo MSIL myTestFile.il e produz um arquivo. dll myNewTestFile.dll.

ilasm myTestFile /dll /output:myNewTestFile.dll

O exemplo de código a seguir mostra um aplicativo extremamente simple que exibe "Hello World!". no console. Você pode compilar esse código e, em seguida, use o Ildasm. exe ferramenta para gerar um arquivo MSIL.

using System;
public class Hello
{
    public static void Main(String[] args)
    {
        Console.WriteLine("Hello World!");
    }
}

O seguinte exemplo de código MSIL corresponde à C# exemplo de código anterior. Você pode compilar este código em um assembly usando o Ilasm. exe (Assembler MSIL) ferramenta. Exemplos de código MSIL e C# exibem "Hello World!". no console.

// Metadata version: v2.0.50215
.assembly extern mscorlib
{
  .publickeytoken = (B7 7A 5C 56 19 34 E0 89 )                         // .z\V.4..
  .ver 2:0:0:0
}
.assembly sample
{
  .custom instance void [mscorlib]System.Runtime.CompilerServices.CompilationRelaxationsAttribute::.ctor(int32) = ( 01 00 08 00 00 00 00 00 ) 
  .hash algorithm 0x00008004
  .ver 0:0:0:0
}
.module sample.exe
// MVID: {A224F460-A049-4A03-9E71-80A36DBBBCD3}
.imagebase 0x00400000
.file alignment 0x00000200
.stackreserve 0x00100000
.subsystem 0x0003       // WINDOWS_CUI
.corflags 0x00000001    //  ILONLY
// Image base: 0x02F20000


// =============== CLASS MEMBERS DECLARATION ===================

.class public auto ansi beforefieldinit Hello
       extends [mscorlib]System.Object
{
  .method public hidebysig static void  Main(string[] args) cil managed
  {
    .entrypoint
    // Code size       13 (0xd)
    .maxstack  8
    IL_0000:  nop
    IL_0001:  ldstr      "Hello World!"
    IL_0006:  call       void [mscorlib]System.Console::WriteLine(string)
    IL_000b:  nop
    IL_000c:  ret
  } // end of method Hello::Main

  .method public hidebysig specialname rtspecialname 
          instance void  .ctor() cil managed
  {
    // Code size       7 (0x7)
    .maxstack  8
    IL_0000:  ldarg.0
    IL_0001:  call       instance void [mscorlib]System.Object::.ctor()
    IL_0006:  ret
  } // end of method Hello::.ctor

} // end of class Hello

Consulte também

Referência

Ildasm. exe (desmontador MSIL)

Prompt de comando Visual Studio

Conceitos

Processo de Execução Gerenciada

Outros recursos

Ferramentas.NET Framework