Cómo: Generar un ensamblado de varios archivos
Actualización: noviembre 2007
En esta sección se describe el procedimiento utilizado para crear un ensamblado de múltiples archivos y se proporciona un ejemplo completo que ilustra cada uno de los pasos del procedimiento.
Para crear un ensamblado de varios archivos
Compile en módulos de código todos los archivos que contengan espacios de nombres a los que hacen referencia otros módulos del ensamblado. La extensión predeterminada de los módulos de código es .netmodule. Por ejemplo, si un archivo denominado Stringer crea un espacio de nombres denominado myStringer al que se hace referencia en el código del archivo Client, Stringer se debería compilar primero en un módulo de código.
Compile los módulos restantes, usando las opciones de compilador necesarias para indicar los otros módulos a los que hace referencia el código.
Use la herramienta Assembly Linker (Al.exe) para crear el archivo de salida que contiene el manifiesto del ensamblado. Este archivo contiene información de referencia de todos los módulos o recursos que forman parte del ensamblado.
.gif "Nota")
Nota:El IDE de Visual Studio 2005 para C# y Visual Basic sólo se puede utilizar para crear ensamblados de un solo archivo. Si se desea crear ensamblados de múltiples archivos, se deben usar compiladores de la línea de comandos o Visual Studio 2005 con Visual C++.
El ejemplo siguiente muestra el paso 1 del procedimiento anterior, compilando los archivos con espacios de nombres a los que hacen referencia otros archivos. Este ejemplo comienza con algo de código sencillo para el archivo Stringer. Éste tiene un espacio de nombres denominado myStringer con una clase denominada Stringer. La clase Stringer contiene un método denominado StringerMethod que escribe una única línea en la consola.
' Assembly building example in the .NET Framework.
Imports System
Namespace myStringer
Public Class Stringer
Public Sub StringerMethod()
Console.WriteLine("This is a line from StringerMethod.")
End Sub
End Class
End Namespace
// Assembly building example in the .NET Framework.
using System;
namespace myStringer
{
public class Stringer
{
public void StringerMethod()
{
System.Console.WriteLine("This is a line from StringerMethod.");
}
}
}
Use el comando siguiente para compilar este código:
vbc /t:module Stringer.vb
csc /t:module Stringer.cs
Si se especifica el parámetro module con la opción de compilador /t: se indica que el archivo se debe compilar como un módulo y no como un ensamblado. El compilador produce un módulo denominado Stringer.netmodule, que se puede agregar a un ensamblado.
En el paso dos del procedimiento anterior, se deben compilar los módulos con referencias a otros módulos. En este paso se usa la opción de compilador /addmodule. En el siguiente ejemplo, un módulo de código denominado Client tiene un método Main de punto de entrada que hace referencia a un método del módulo Stringer.dll creado en el paso 1.
En el siguiente ejemplo se muestra el código de Client.
Imports System
Imports myStringer 'The namespace created in Stringer.netmodule.
Class MainClientApp
' Shared method Main is the entry point method.
Public Shared Sub Main()
Dim myStringInstance As New Stringer()
Console.WriteLine("Client code executes")
'myStringComp.Stringer()
myStringInstance.StringerMethod()
End Sub
End Class
using System;
using myStringer; //The namespace created in Stringer.netmodule.
class MainClientApp
{
// Static method Main is the entry point method.
public static void Main()
{
Stringer myStringInstance = new Stringer();
Console.WriteLine("Client code executes");
//myStringComp.Stringer();
myStringInstance.StringerMethod();
}
}
Use el comando siguiente para compilar este código:
vbc /addmodule:Stringer.netmodule /t:module Client.vb
csc /addmodule:Stringer.netmodule /t:module Client.cs
Especifique la opción /t:module, ya que este módulo se va a agregar a un ensamblado en un paso posterior. Especifique la opción /addmodule, ya que el código de Client hace referencia a un espacio de nombres creado por el código en Stringer.netmodule. El compilador produce un módulo denominado Client.netmodule que contiene una referencia a otro módulo, Stringer.netmodule.
| Nota: |
|---|
Los compiladores de C# y Visual Basic son compatibles con la creación directa de ensamblados de múltiples archivos mediante las dos siguientes sintaxis distintas. |
Dos compilaciones crean un ensamblado de dos archivos:
vbc /t:module Stringer.vb vbc Client.vb /addmodule:Stringer.netmodulecsc /t:module Stringer.cs csc Client.cs /addmodule:Stringer.netmoduleUna compilación crea un ensamblado de dos archivos:
vbc /out:Stringer.netmodule Stringer.vb /out:Client.exe Client.vbcsc /out:Client.exe Client.cs /out:Stringer.netmodule Stringer.cs
La herramienta Assembly Linker (Al.exe) se puede usar para crear un ensamblado a partir de una colección de módulos de código compilados.
Para crear un ensamblado de varios archivos mediante la herramienta Assembly Linker
En el símbolo del sistema, escriba el siguiente comando:
al <nombre del módulo> <nombre del módulo> … /main:<nombre del método> /out:<nombre de archivo> /target:<tipo de archivo del ensamblado>
En este comando, los argumentos de nombre de archivo especifican el nombre de todos los módulos que se van a incluir en el ensamblado. La opción /main: especifica el nombre del método que es el punto de entrada del ensamblado. La opción /out: especifica el nombre del archivo de salida que contiene metadatos del ensamblado. La opción /target: especifica que el ensamblado es un archivo ejecutable de aplicación de consola (.exe), un archivo ejecutable de Windows (.win) o un archivo de biblioteca (.lib).
En el siguiente ejemplo, Al.exe crea un ensamblado que es un ejecutable de aplicación de consola denominado myAssembly.exe. Esta aplicación está formada por dos módulos denominados Client.netmodule y Stringer.netmodule y el archivo ejecutable denominado myAssembly.exe, que sólo contiene metadatos del ensamblado. El punto de entrada del ensamblado es el método Main de la clase MainClientApp, que se encuentra en Client.dll.
al Client.netmodule Stringer.netmodule /main:MainClientApp.Main /out:myAssembly.exe /target:exe
Se puede usar el Desensamblador de MSIL (Ildasm.exe) para examinar el contenido de un ensamblado, o determinar si un archivo es un ensamblado o un módulo.
Vea también
Tareas
Cómo: Ver el contenido de un ensamblado