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 |
---|---|
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
Referencia de esquemas del archivo de proyecto MSBuild