Elemento Task (MSBuild)

Artigo
06/09/2015

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

<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 elementos filho, atributos, e elementos pai.

Atributos

Atributo	Descrição
Condition	atributo opcional. Condição a ser avaliada. Para obter mais informações, consulte Condições do MSBuild.
ContinueOnError	atributo opcional. Pode conter um dos seguintes valores: WarnAndContinue ou true. Quando uma tarefa falhar, as tarefas subseqüentes no elemento de Destino na compilação e continuar a executar, e todos os erros de tarefa são tratados como avisos. ErrorAndContinue. Quando uma tarefa falhar, as tarefas subseqüentes no elemento de Target na compilação e continuar a executar, e todos os erros de tarefa são tratados como erros. ErrorAndStop ou false (padrão). Quando uma tarefa falhar, as outras tarefas no elemento de Target e na compilação não são executadas, e o elemento inteiro de Target e a construção são considerados ter falhado. As versões do .NET Framework 4,5 antes de suportavam apenas os valores de true e de false . Para obter mais informações, consulte Como ignorar erros em tarefas.
Parameter	Necessário se a classe de tarefa contém uma ou mais propriedades rotuladas com o atributo de [Required] . Um parâmetro definido pelo usuário na tarefa que contém o valor do parâmetro como seu valor. Pode haver qualquer número de parâmetros no elemento de Task , com cada atributo que mapeia a uma propriedade .NET na classe de tarefas.

Condition

atributo opcional. Condição a ser avaliada. Para obter mais informações, consulte Condições do MSBuild.

ContinueOnError

atributo opcional. Pode conter um dos seguintes valores:

WarnAndContinue ou true. Quando uma tarefa falhar, as tarefas subseqüentes no elemento de Destino na compilação e continuar a executar, e todos os erros de tarefa são tratados como avisos.
ErrorAndContinue. Quando uma tarefa falhar, as tarefas subseqüentes no elemento de Target na compilação e continuar a executar, e todos os erros de tarefa são tratados como erros.
ErrorAndStop ou false (padrão). Quando uma tarefa falhar, as outras tarefas no elemento de Target e na compilação não são executadas, e o elemento inteiro de Target e a construção são considerados ter falhado.

As versões do .NET Framework 4,5 antes de suportavam apenas os valores de true e de false .

Para obter mais informações, consulte Como ignorar erros em tarefas.

Parameter

Necessário se a classe de tarefa contém uma ou mais propriedades rotuladas com o atributo de [Required] .

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

Elementos filho

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

Elementos pai

Elemento	Descrição
Destino	Elemento contêiner para tarefas de MSBuild .

Comentários

Um elemento de Task em um arquivo de projeto de MSBuild cria uma instância de uma tarefa, define propriedades em ele, e as executa em. Parâmetros de saída dos armazenamentos do elemento de Output nas propriedades ou nos itens a serem usadas em qualquer lugar no arquivo de projeto.

Se houver qualquer elemento de OnError no elemento pai de Target de uma tarefa, serão avaliados ainda se a tarefa falha e ContinueOnError tem um valor de false. Para obter mais informações sobre as tarefas, consulte Tarefas do MSBuild.

Exemplo

O exemplo de código a seguir cria uma instância da classe de Tarefa de CSC , define seis propriedades, e executar a tarefa. Após a execução, o valor da propriedade de OutputAssembly de objeto é colocado em uma lista de itens FinalAssemblyNamechamada.

<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>

Consulte também

Conceitos

Tarefas do MSBuild

Referência do esquema de arquivos de projeto do MSBuild

Outros recursos

Referência das tarefas do MSBuild

Compartilhar via