Elemento UsingTask (MSBuild)

Actualización: noviembre 2007

Asigna la tarea referenciada en un elemento Task al ensamblado que contiene la implementación de la tarea.

<UsingTask TaskName="TaskName"
    AssemblyName = "AssemblyName" 
    Condition="'String A'=='String B'" />

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo	Descripción
AssemblyName	Se requiere el atributo AssemblyName o el atributo AssemblyFile. Nombre del ensamblado que se va a cargar. El atributo AssemblyName acepta los ensamblados con nombre seguro aunque no se requiere. Utilizar este atributo equivale a cargar un ensamblado con el método Load de .NET Framework. No puede utilizar este atributo si se utiliza el atributo AssemblyFile.
AssemblyFile	Se requiere el atributo AssemblyName o el atributo AssemblyFile. Ruta de acceso de archivo al ensamblado. Este atributo acepta rutas de acceso completas y relativas. Las rutas de acceso relativas son relativas al directorio de los archivos de proyecto o destino donde se declara el elemento UsingTask. Utilizar este atributo equivale a cargar un ensamblado con el método LoadFrom de .NET Framework. No puede utilizar este atributo si se utiliza el atributo AssemblyName.
TaskName	Atributo necesario. El nombre de la tarea a la que se hará referencia desde un ensamblado. Si las ambigüedades son posibles, este atributo deberá siempre especificar espacios de nombres completos. Si hay ambigüedades, MSBuild elegirá una coincidencia arbitraria que podría producir resultados inesperados.
Condition	Atributo opcional. Condición que se va a evaluar. Para obtener más información, vea Condiciones de MSBuild.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
Project	Elemento raíz necesario de un archivo de proyecto de MSBuild.

Comentarios

Se puede hacer referencia a las variables de entorno, propiedades de línea de comandos y propiedades en el nivel de proyecto en cualquier lugar dentro del elemento UsingTask siempre que aparezcan dentro del archivo de proyecto, ya sea de forma explícita o mediante un archivo de proyecto importado. Para obtener más información, vea Tareas de MSBuild.

Nota

Las propiedades en el nivel de proyecto no tienen ningún significado si el elemento UsingTask proviene de uno de los archivos .tasks registrados globalmente con el motor de MSBuild. Estas propiedades no son globales de MSBuild.

Ejemplo

En el ejemplo siguiente se muestra cómo utilizar el elemento UsingTask con un atributo AssemblyName.

<UsingTask TaskName="Microsoft.Build.Tasks.Csc"
              AssemblyName="Microsoft.Build.Tasks" />

En el ejemplo siguiente se muestra cómo utilizar el elemento UsingTask con un atributo AssemblyFile.

<UsingTask TaskName="Email"
              AssemblyFile="c:\myTasks\myTask.dll" />

Vea también

Conceptos

Tareas de MSBuild

Referencia de esquemas del archivo de proyecto MSBuild

Otros recursos

Referencia de tareas de MSBuild