AL (Assembly Linker, Tarea)

La tarea AL contiene AL.exe, una herramienta que se distribuye con el kit de desarrollo de software (SDK) de Windows. La herramienta Assembly Linker se utiliza para crear un ensamblado con un manifiesto a partir de uno o varios archivos que pueden ser módulos o archivos de recursos. Los compiladores y los entornos de desarrollo pueden proporcionar estas capacidades, por lo que a menudo no hace falta utilizar esta tarea directamente. Assembly Linker resulta de más utilidad para los programadores que necesitan crear un único ensamblado a partir de varios archivos de componentes, como los que se pueden producir en desarrollos de lenguajes combinados. Esta tarea no combina los módulos en un único archivo de ensamblado; los módulos individuales deben distribuirse y estar disponibles para que el ensamblado resultante se cargue correctamente. Para obtener más información sobre AL.exe, vea Al.exe (Assembly Linker).

Parámetros

En la siguiente tabla se describen los parámetros de la tarea AL .

Parámetro	Descripción
AlgorithmID	Parámetro String opcional. Especifica un algoritmo que genera un valor hash para todos los archivos en un ensamblado de múltiples archivos, exceptuando el archivo que contiene el manifiesto del ensamblado. Para obtener más información, consulte la documentación sobre la opción /algid en Al.exe (Assembly Linker).
BaseAddress	Parámetro String opcional. Especifica la dirección donde se cargará un archivo DLL en el equipo del usuario en tiempo de ejecución. Las aplicaciones se cargan con mayor rapidez si se especifica la dirección base de los archivos DLL, en lugar de dejar que el sistema operativo cambie la ubicación de los mismos en el espacio de procesos. Este parámetro corresponde a la opción /baseaddress.
CompanyName	Parámetro String opcional. Especifica una cadena para el campo Company del ensamblado. Para obtener más información, consulte la documentación sobre la opción /comp[any] en Al.exe (Assembly Linker).
Configuration	Parámetro String opcional. Especifica una cadena para el campo Configuration del ensamblado. Para obtener más información, consulte la documentación sobre la opción /config[uration] en Al.exe (Assembly Linker).
Copyright	Parámetro String opcional. Especifica una cadena para el campo Copyright del ensamblado. Para obtener más información, consulte la documentación sobre la opción /copy[right] en Al.exe (Assembly Linker).
Culture	Parámetro String opcional. Especifica la cadena de referencia cultural que se va a asociar al ensamblado. Para obtener más información, consulte la documentación sobre la opción /c[ulture] en Al.exe (Assembly Linker).
DelaySign	Parámetro Boolean opcional. true para colocar solo la clave pública en el ensamblado; false para firmar completamente el ensamblado. Para obtener más información, consulte la documentación sobre la opción /delay[sign] en Al.exe (Assembly Linker).
Description	Parámetro String opcional. Especifica una cadena para el campo Description del ensamblado. Para obtener más información, consulte la documentación sobre la opción /descr[iption] en Al.exe (Assembly Linker).
EmbedResources	Parámetro ITaskItem[] opcional. Inserta los recursos especificados en la imagen que contiene el manifiesto del ensamblado. Esta tarea copia el contenido del archivo de recursos en la imagen. Los elementos pasados a este parámetro pueden tener metadatos opcionales adjuntos a los mismos denominados LogicalName y Access. Los metadatos LogicalName se utilizan para especificar el identificador interno del recurso. Los metadatos Access se pueden establecer en private para que el recurso no sea visible para otros ensamblados. Para obtener más información, consulte la documentación sobre la opción /embed[resource] en Al.exe (Assembly Linker).
EvidenceFile	Parámetro String opcional. Inserta el archivo especificado en el ensamblado con el nombre de recurso Security.Evidence. No se puede usar Security.Evidence para los recursos habituales. Este parámetro corresponde a la opción /e[vidence] de Al.exe (Assembly Linker).
ExitCode	Parámetro de solo lectura de salida Int32 opcional. Especifica el código de salida proporcionado por el comando ejecutado.
FileVersion	Parámetro String opcional. Especifica una cadena para el campo File Version del ensamblado. Para obtener más información, consulte la documentación sobre la opción /fileversion en Al.exe (Assembly Linker).
Flags	Parámetro String opcional. Especifica un valor para el campo Flags del ensamblado. Para obtener más información, consulte la documentación sobre la opción /flags en Al.exe (Assembly Linker).
GenerateFullPaths	Parámetro Boolean opcional. Hace que la tarea use la ruta de acceso absoluta de los archivos que se enumeran en un mensaje de error. Este parámetro corresponde a la opción /fullpaths de Al.exe (Assembly Linker).
KeyContainer	Parámetro String opcional. Especifica un contenedor que contiene un par de claves. De este modo, el ensamblado se firmará (recibirá un nombre seguro) mediante la inserción de una clave pública en el manifiesto del ensamblado. La tarea firmará después el ensamblado final con la clave privada. Para obtener más información, consulte la documentación sobre la opción /keyn[ame] en Al.exe (Assembly Linker).
KeyFile	Parámetro String opcional. Especifica un archivo que contiene un par de claves o simplemente una clave pública para firmar un ensamblado. El compilador inserta la clave pública en el manifiesto del ensamblado y firma después el ensamblado final con la clave privada. Para obtener más información, consulte la documentación sobre la opción /keyf[ile] en Al.exe (Assembly Linker).
LinkResources	Parámetro ITaskItem[] opcional. Vincula los archivos de recursos especificados a un ensamblado. El recurso pasa a formar parte del ensamblado, pero el archivo no se copia. Los elementos pasados a este parámetro pueden tener metadatos opcionales adjuntos a los mismos denominados LogicalName, Target y Access. Los metadatos LogicalName se utilizan para especificar el identificador interno del recurso. Los metadatos Target pueden especificar el nombre de archivo y la ruta de acceso donde la tarea copia el archivo, tras lo cual compila este nuevo archivo en el ensamblado. Los metadatos Access se pueden establecer en private para que el recurso no sea visible para otros ensamblados. Para obtener más información, consulte la documentación sobre la opción /link[resource] en Al.exe (Assembly Linker).
MainEntryPoint	Parámetro String opcional. Especifica el nombre completo (class.method) del método que se utilizará como punto de entrada al convertir un módulo en un archivo ejecutable. Este parámetro corresponde a la opción /main de Al.exe (Assembly Linker).
OutputAssembly	Parámetro de salida obligatorio de tipo ITaskItem. Especifica el nombre del archivo generado por esta tarea. Este parámetro corresponde a la opción /out de Al.exe (Assembly Linker).
Platform	Parámetro String opcional. Limita en qué plataforma se puede ejecutar este código; debe ser x86, Itanium, x64 o anycpu. De manera predeterminada, es anycpu. Este parámetro corresponde a la opción /platform de Al.exe (Assembly Linker).
ProductName	Parámetro String opcional. Especifica una cadena para el campo Product del ensamblado. Para obtener más información, consulte la documentación sobre la opción /prod[uct] en Al.exe (Assembly Linker).
ProductVersion	Parámetro String opcional. Especifica una cadena para el campo ProductVersion del ensamblado. Para obtener más información, consulte la documentación sobre la opción /productv[ersion] en Al.exe (Assembly Linker).
ResponseFiles	Parámetro String[] opcional. Especifica los archivos de respuesta que contienen las opciones adicionales que deben pasarse a Assembly Linker.
SdkToolsPath	Parámetro String opcional. Especifica la ruta de acceso a las herramientas del SDK, tales como resgen.exe.
SourceModules	Parámetro ITaskItem[] opcional. Uno o varios módulos que se compilarán en un ensamblado. Los módulos aparecerán en una lista en el manifiesto del ensamblado resultante, y tendrán que distribuirse y estar disponibles para poder cargar el ensamblado. Los elementos que se pasan a este parámetro pueden tener metadatos adicionales denominados Target, que especifican la ruta y el nombre de archivo en el que la tarea copia el archivo, tras lo cual compilará este nuevo archivo en el ensamblado. Para obtener más información, consulte la documentación de Al.exe (Assembly Linker). Este parámetro corresponde a la lista de módulos pasados a Al.exe sin un modificador concreto.
TargetType	Parámetro String opcional. Especifica el formato del archivo de salida: library (biblioteca de códigos), exe (aplicación de consola) o win (aplicación basada en Windows). De manera predeterminada, es library. Este parámetro corresponde a la opción /t[arget] de Al.exe (Assembly Linker).
TemplateFile	Parámetro String opcional. Especifica el ensamblado del que se heredarán todos los metadatos del ensamblado, salvo el campo correspondiente a la referencia cultural. El ensamblado especificado debe tener un nombre seguro. El ensamblado creado con el parámetro TemplateFile será un ensamblado satélite. Este parámetro corresponde a la opción /template de Al.exe (Assembly Linker).
Timeout	Parámetro Int32 opcional. Especifica el tiempo en milisegundos después del cual se termina la tarea ejecutable. El valor predeterminado es Int.MaxValue, que indica que no hay período de tiempo de espera.
Title	Parámetro String opcional. Especifica una cadena para el campo Title del ensamblado. Para obtener más información, consulte la documentación sobre la opción /title en Al.exe (Assembly Linker).
ToolPath	Parámetro String opcional. Especifica la ubicación desde donde la tarea cargará el archivo ejecutable subyacente (Al.exe). Si no se especifica este parámetro, la tarea usa la ruta de instalación del SDK que se corresponde con la versión de la plataforma que está ejecutando MSBuild.
Trademark	Parámetro String opcional. Especifica una cadena para el campo Trademark del ensamblado. Para obtener más información, consulte la documentación sobre la opción /trade[mark] en Al.exe (Assembly Linker).
Version	Parámetro String opcional. Especifica la información de versión de este ensamblado. El formato de la cadena es principal.secundaria.compilación.revisión. El valor predeterminado es 0. Para obtener más información, consulte la documentación sobre la opción /v[ersion] en Al.exe (Assembly Linker).
Win32Icon	Parámetro String opcional. Inserta un archivo .ico en el ensamblado. El archivo .ico proporciona al archivo de salida la apariencia deseada en el Explorador de archivos. Este parámetro corresponde a la opción /win32icon de Al.exe (Assembly Linker).
Win32Resource	Parámetro String opcional. Inserta un recurso de Win32 (archivo .res) en el archivo de salida. Para obtener más información, consulte la documentación sobre la opción /win32res en Al.exe (Assembly Linker).

Parámetros de ToolTaskExtension

Esta tarea hereda de la clase ToolTaskExtension, que hereda de la clase ToolTask, la cual, a su vez, hereda de la clase Task. Esta cadena de herencia agrega varios parámetros a las tareas que derivan de ellos.

En la siguiente tabla se describen los parámetros de las clases base:

Parámetro	Descripción
EchoOff	Parámetro bool opcional. Cuando se establece en true, esta tarea pasa /Q a la línea de comandos cmd.exe de modo que la línea de comandos no se copia en stdout.
EnvironmentVariables	Parámetro de matriz String opcional. Matriz de definiciones de variables de entorno, separadas por punto y coma. Cada definición debe especificar un valor y un nombre para la variable de entorno separados por un signo igual. Estas variables se pasan al ejecutable generado y, además, pasan el bloque de entorno normal o lo invalidan de manera selectiva. Por ejemplo, Variable1=Value1;Variable2=Value2.
ExitCode	Parámetro de solo lectura de salida Int32 opcional. Especifica el código de salida proporcionado por el comando ejecutado. Si la tarea registró errores pero el proceso tenía un código de salida de 0 (correcto), se establece en -1.
LogStandardErrorAsError	Parámetro bool opcional. Si true, todos los mensajes recibidos en el flujo de error estándar se registran como errores.
StandardErrorImportance	Parámetro String opcional. Importancia con la que se va a registrar el texto de la secuencia de error estándar.
StandardOutputImportance	Parámetro String opcional. Importancia con la que se va a registrar el texto de la secuencia de salida estándar.
Timeout	Parámetro Int32 opcional. Especifica el tiempo en milisegundos después del cual se termina la tarea ejecutable. El valor predeterminado es Int.MaxValue, que indica que no hay período de tiempo de espera. Tiempo de espera en milisegundos.
ToolExe	Parámetro string opcional. Los proyectos pueden implementarlo para invalidar ToolName. Las tareas pueden invalidarlo para conservar ToolName.
ToolPath	Parámetro string opcional. Especifica la ubicación desde donde la tarea carga el archivo ejecutable subyacente. Si no se especifica este parámetro, la tarea usa la ruta de instalación del SDK que se corresponde con la versión del marco de trabajo que está ejecutando MSBuild.
UseCommandProcessor	Parámetro bool opcional. Cuando se establece en true, esta tarea crea un archivo por lotes para la línea de comandos y lo ejecuta mediante el procesador de comandos, en lugar de ejecutar el comando directamente.
YieldDuringToolExecution	Parámetro bool opcional. Cuando se establece en true, esta tarea produce el nodo cuando se ejecuta la tarea.

Ejemplo

En el ejemplo siguiente se crea un ensamblado con las opciones especificadas.

<AL
    EmbedResources="@(EmbeddedResource)"
    Culture="%(EmbeddedResource.Culture)"
    TemplateFile="@(IntermediateAssembly)"
    KeyContainer="$(KeyContainerName)"
    KeyFile="$(KeyOriginatorFile)"
    DelaySign="$(DelaySign)"

    OutputAssembly=
       "%(EmbeddedResource.Culture)\$(TargetName).resources.dll">

    <Output TaskParameter="OutputAssembly"
        ItemName="SatelliteAssemblies"/>
</AL>

Vea también

• Referencia de tareas
• Tareas