Elemento Task (MSBuild)

Artículo
10/07/2008

Actualización: noviembre 2007

Crea y ejecuta una instancia de una tarea de MSBuild. El nombre del elemento se determina mediante el nombre de la tarea que se está creando.

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="true/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

Atributos y elementos

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

Atributos

Atributo	Descripción
Condition	Atributo opcional. Condición que se va a evaluar. Para obtener más información, vea Condiciones de MSBuild.
ContinueOnError	Atributo opcional. Un atributo booleano que tiene como valor predefinido false si no se especifica. Si ContinueOnError es false y falla una tarea, las tareas restantes en el elemento Target no se ejecutan y se considera que todo el elemento Target ha fallado. Si este atributo es true, las tareas subsiguientes del elemento Target se siguen ejecutando aunque se produzca un error en la tarea actual y todos los errores de la tarea se tratan como advertencias.
Parameter	Requerido si la clase de tarea contiene una o más propiedades etiquetadas con el atributo [Required]. Un parámetro de tarea definido por el usuario que contiene el valor de parámetro como su valor. Puede haber cualquier número de parámetros en el elemento Task, con cada atributo asignado a una propiedad de .NET en la clase de tarea.

Condition

Atributo opcional. Condición que se va a evaluar. Para obtener más información, vea Condiciones de MSBuild.

ContinueOnError

Atributo opcional. Un atributo booleano que tiene como valor predefinido false si no se especifica. Si ContinueOnError es false y falla una tarea, las tareas restantes en el elemento Target no se ejecutan y se considera que todo el elemento Target ha fallado.

Si este atributo es true, las tareas subsiguientes del elemento Target se siguen ejecutando aunque se produzca un error en la tarea actual y todos los errores de la tarea se tratan como advertencias.

Parameter

Requerido si la clase de tarea contiene una o más propiedades etiquetadas con el atributo [Required].

Un parámetro de tarea definido por el usuario que contiene el valor de parámetro como su valor. Puede haber cualquier número de parámetros en el elemento Task, con cada atributo asignado a una propiedad de .NET en la clase de tarea.

Elementos secundarios

Elemento	Descripción
Output	Almacena los resultados de la tarea en el archivo de proyecto. Puede haber cero o más elementos Output en una tarea.

Elementos primarios

Elemento	Descripción
Target	Elemento contenedor de tareas de MSBuild.

Comentarios

Un elemento Task en un archivo de proyecto de MSBuild crea una instancia de una tarea, establece las propiedades y la ejecuta. El elemento Output almacena los parámetros de salida en propiedades o elementos que se van a utilizar en otra parte en el archivo de proyecto.

Si existen elementos OnError en el elemento principal Target de una tarea, podrán evaluarse si la tarea falla y ContinueOnError tiene un valor de false. Para obtener información sobre las tareas, vea Tareas de MSBuild.

Ejemplo

En el siguiente ejemplo de código se crea una instancia de la clase Csc task, establece seis de las propiedades y ejecuta la tarea. Después de la ejecución, el valor de la propiedad OutputAssembly del objeto se coloca en una lista de elementos denominada FinalAssemblyName.

<Target Name="Compile" DependsOnTarget="Resources" >
    <Csc Sources="@(CSFile)"
          TargetType="library"
          Resources="@(CompiledResources)"
          EmitDebugInformation="$(includeDebugInformation)"
          References="@(Reference)"
          DebugType="$(debuggingType)" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
    </Csc>
</Target>

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