Elemento Task de Target (MSBuild)

  • Artigo

Cria e executa uma instância de uma tarefa do MSBuild. O nome do elemento é determinado pelo nome da tarefa que está sendo criada.

<Projeto><Target>

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição
Condition Atributo opcional. Condição a ser avaliada. Para obter mais informações, consulte Condições.
ContinueOnError Atributo opcional. Pode conter um dos seguintes valores:

- WarnAndContinue ou true. Quando uma tarefa falha, as tarefas subsequentes no elemento de Destino e o build continuam em execução e todos os erros da tarefa são tratados como avisos.
- ErrorAndContinue. Quando uma tarefa falha, as tarefas subsequentes no elemento de Target e o build continuam em execução e todos os erros da tarefa são tratados como erros.
- ErrorAndStop ou false (padrão). Quando uma tarefa falha, as tarefas restantes do elemento de Target e o build não são executadas e todo o elemento de Target e o build são considerados como em falha.

As versões do .NET Framework antes da 4.5 ofereciam suporte somente aos valores true e false.

Para saber mais, confira Como ignorar erros em tarefas.
Parameter Será necessário se a classe de tarefa contiver uma ou mais propriedades rotuladas com o atributo [Required].

Um parâmetro de tarefa definido pelo usuário que contém o valor do parâmetro como seu valor. Pode haver qualquer quantidade de parâmetros no elemento Task, com cada atributo mapeado para uma propriedade do .NET na classe tarefa.

Elementos filho

Elemento Descrição
Saída Armazena saídas da tarefa no arquivo de projeto. Pode haver zero ou mais elementos Output em uma tarefa.

Elementos pai

Elemento Descrição
Target (destino) Elemento Container para tarefas do MSBuild.

Comentários

Um elemento Task em um arquivo de projeto do MSBuild cria uma instância de uma tarefa, define suas propriedades e a executa. O elemento Output armazena parâmetros de saída em propriedades ou itens para serem usados em outro local do arquivo de projeto.

Se houver elementos OnError no elemento pai Target de uma tarefa, eles ainda serão avaliados se a tarefa falhar e ContinueOnError tiver o valor de false. Para obter mais informações sobre tarefas, consulte Tarefas.

Exemplo

O exemplo de código a seguir cria uma instância da classe tarefa Csc, define seis propriedades e executa a tarefa. Após a execução, o valor da propriedade OutputAssembly do objeto é colocada em uma lista de itens com o nome 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>

Confira também