Elemento Task de Target (MSBuild)

  • Artículo

Crea y ejecuta una instancia de una tarea de MSBuild. El nombre del elemento se determina viene determinado por el nombre de la tarea que se va a crear.

<Proyecto><Target>

Sintaxis

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

Atributos y elementos

En las siguientes 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, consulte Condiciones.
ContinueOnError Atributo opcional. Puede contener uno de los siguientes valores:

- WarnAndContinue o true. Cuando se produce un error en una tarea, las tareas subsiguientes en el elemento Target y la compilación continúan ejecutándose, y todos los errores de la tarea se tratan como advertencias.
- ErrorAndContinue. Cuando se produce un error en una tarea, las tareas subsiguientes en el elemento Target y la compilación continúan ejecutándose, y todos los errores de la tarea se tratan como errores.
- ErrorAndStop o false (valor predeterminado). Cuando se produce un error en una tarea, las tareas restantes en el elemento Target y la compilación no se ejecutan, y se considera que se ha producido un error en todo el elemento Target y la compilación.

Las versiones de .NET Framework anteriores a 4.5 solo admiten los valores true y false.

Para obtener más información, vea Cómo: Pasar errores por alto en las tareas.
Parameter Se necesita 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 del parámetro como su valor. Puede haber cualquier número de parámetros en el elemento Task, con cada asignación de atributo a una propiedad de .NET en la clase de tarea.

Elementos secundarios

Elemento Descripción
Salida Almacena salidas 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 para tareas de MSBuild.

Comentarios

Un elemento Task en un archivo de proyecto de MSBuild crea una instancia de una tarea, establece propiedades en ella y la ejecuta. El elemento Output almacena los parámetros de salida en propiedades o elementos que se usarán en otro lugar en el archivo de proyecto.

Si hay algún elemento OnError en el elemento Target principal de una tarea, se evaluará si se produce un error en la tarea y ContinueOnError tiene un valor de false. Para más información sobre las tareas, consulte Tareas.

Ejemplo

El ejemplo de código siguiente se crea una instancia de la clase tarea Csc, 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