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 |
|---|---|
El conjunto de parámetros que aparecen en la tarea que se genera mediante la TaskFactory especificada. |
|
Los datos que se pasan a TaskFactory para generar una instancia de la tarea. |
Elementos primarios
Elemento |
Descripción |
|---|---|
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
Referencia de esquemas del archivo de proyecto MSBuild