Compartir a través de


Elemento Task (MSBuild)

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="WarnAndContinue/true/ErrorAndContinue/ErrorAndStop/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los 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.Puede contener uno de los siguientes valores:

  • WarnAndContinue o true.Cuando una tarea, las tareas siguientes en el elemento Destino y compilación continúan ejecutándose, y todos los errores de la tarea se tratan como advertencias.

  • ErrorAndContinue.Cuando una tarea, las tareas siguientes en el elemento Target y compilación continúan ejecutándose, y todos los errores de la tarea se tratan como errores.

  • ErrorAndStop o false (valor predeterminado).Cuando una tarea, las tareas restantes del elemento Target y la compilación no se ejecutan, y el elemento completo Target y la compilación se considera un error.

Las versiones de .NET Framework antes de 4,5 admitidos los valores únicamente true y false .

Para obtener más información, vea Cómo: Pasar errores por alto en las tareas.

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

Destino

Elemento contenedor de tareas de MSBuild.

Comentarios

Un elemento Task en un archivo de proyecto de MSBuild crea una instancia de una tarea, establece sus 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 más 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