Compartir a través de


Elemento UsingTask (MSBuild)

Asigna la tarea a la que se hace referencia en un elemento Task al ensamblado que contiene la implementación de la tarea.

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

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los 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 requieren.Utilizar este atributo equivale a cargar un ensamblado mediante 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 del ensamblado.Este atributo acepta rutas de acceso completas o relativas.Las rutas de acceso relativas son relativas al directorio del archivo de proyecto o destino donde se declara el elemento UsingTask.Utilizar este atributo equivale a cargar un ensamblado mediante el método LoadFrom de .NET Framework.

No puede utilizar este atributo si se utiliza el atributo AssemblyName.

TaskFactory

Atributo opcional.

Especifica la clase del ensamblado que es responsable de generar instancias del nombre Task especificado. El usuario también puede especificar un TaskBody como un elemento secundario que la fábrica de tareas recibe y utiliza para generar la tarea.El contenido de TaskBody es específico de la fábrica de la tarea.

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.

La condición que se va a evaluar.Para obtener más información, vea Condiciones de MSBuild.

Elementos secundarios

Elemento

Descripción

ParameterGroup

El conjunto de parámetros que aparecen en la tarea que se genera mediante la TaskFactory especificada.

TaskBody

Los datos que se pasan a TaskFactory para generar una instancia de la tarea.

Elementos primarios

Elemento

Descripción

Proyecto

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 del elemento UsingTask siempre que aparezcan en el 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.Las propiedades de nivel de proyecto no son globales en MSBuild.

En MSBuild 4.0, UsingTask se puede cargar a partir de archivos .overridetask.

Ejemplo

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

<UsingTask TaskName="MyTask" AssemblyName="My.Assembly" TaskFactory="MyTaskFactory">
       <ParameterGroup>
              <Parameter1 ParameterType="System.String" Required="False" Output="False"/>
              <Parameter2 ParameterType="System.Int" Required="True" Output="False"/>
              ...
</ParameterGroup>
       <TaskBody>
      ... Task factory-specific data ...
       </TaskBody>
</UsingTask>

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