Elemento UsingTask (MSBuild)

Artículo
08/10/2011

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 secciones siguientes 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

Compartir a través de