Ensamblador de MSIL (Ilasm.exe)

El Ensamblador de MSIL genera un archivo ejecutable portable (PE) a partir del Lenguaje intermedio de Microsoft (MSIL). (Para obtener más información sobre MSIL, vea Compilar en lenguaje intermedio de Microsoft (MSIL)). Se puede ejecutar el archivo ejecutable resultante, que contiene MSIL y los metadatos requeridos, para determinar si MSIL se comporta de acuerdo con lo esperado.

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

Parámetros

Comentarios

El ensamblador de MSIL ayuda a los proveedores de herramientas a diseñar e implementar generadores de MSIL. Mediante la utilización de Ilasm.exe, los programadores de herramientas y compiladores se pueden concentrar en la generación de MSIL y metadatos despreocupándose de la emisión de MSIL en el formato de archivo PE.

Al igual que otros compiladores orientados a Common Language Runtime, como C# y Visual Basic, Ilasm.exe no produce archivos intermedios de objetos y no requiere una fase de vinculación para crear un archivo PE.

El ensamblador de MSIL puede expresar todos los metadatos existentes y las funciones de MSIL que caracterizan a los lenguajes de programación orientados a Common Language Runtime. Esto permite que el código administrado escrito en cualquiera de estos lenguajes de programación se pueda expresar en el Ensamblador de MSIL y compilar con Ilasm.exe de forma correcta.

Se puede utilizar Ilasm.exe conjuntamente con su herramienta complementaria Ildasm.exe. A partir de un archivo PE que contiene código MSIL, Ildasm.exe crea un archivo de texto apropiado como entrada para Ilasm.exe. Esta técnica es muy útil cuando, por ejemplo, se compila código en un lenguaje de programación que no admite todos los atributos de metadatos en tiempo de ejecución. Una vez compilado el código y ejecutados los resultados mediante Ildasm.exe, el archivo de texto de MSIL resultante se puede editar manualmente para agregar los atributos que faltan. A continuación, se puede ejecutar este archivo de texto mediante Ilasm.exe para producir un archivo ejecutable final.

También se puede utilizar esta técnica para producir un único archivo PE a partir de varios archivos PE generados originalmente por varios compiladores diferentes.

Para que la utilización combinada de Ildasm.exe e Ilasm.exe tenga la mayor precisión posible, el ensamblador no realiza optimizaciones simples ni se detiene a considerar si debe utilizar instrucciones en formato largo o corto. Por ejemplo, la herramienta no intenta determinar si puede sustituir una codificación con formato corto por otra con formato largo que se haya podido escribir en los códigos fuente MSIL (o que pueda emitir otro compilador). Si se desea la codificación con formato corto, se debe escribir explícitamente con dicho formato. No obstante, el ensamblador comprueba si hay condiciones fuera del intervalo donde esto sea posible.

Ejemplos

El comando siguiente ensambla el archivo MSIL myTestFile.il y produce el archivo ejecutable myTestFile.exe.

ilasm myTestFile

El comando siguiente ensambla el archivo MSIL myTestFile.il y produce el archivo .dll myTestFile.dll.

ilasm myTestFile /dll 

El comando siguiente ensambla el archivo MSIL myTestFile.il y produce el archivo .dll myNewTestFile.dll.

ilasm myTestFile /dll /output:myNewTestFile.dll

En el siguiente ejemplo de código se muestra una aplicación muy simple que muestra "Hola a todos" en la consola. Puede compilar este código y, a continuación, utilizar la herramienta Ildasm.exe para generar un archivo MSIL.

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

El siguiente ejemplo de código de MSIL se corresponde con el ejemplo de código de C# anterior. Puede compilar este código en un ensamblado utilizando la herramienta Ensamblador de MSIL (Ilasm.exe). Tanto el ejemplo de código de MSIL como el de C# muestran "Hola a todos" en la consola.

// 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

Vea también

Referencia

Herramientas de .NET Framework
Desensamblador de MSIL (Ildasm.exe)
Símbolo del sistema de SDK

Conceptos

Compilar en lenguaje intermedio de Microsoft (MSIL)