Elemento Task (MSBuild)

Artigo
08/01/2011

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

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="true/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 do MSBuild.
ContinueOnError	Atributo opcional. Um atributo booleano, padrões para false se não for especificado. Se ContinueOnError é false e uma falha da tarefa, as tarefas restantes do destino elemento não são executadas e todo o Target elemento é considerado falha. Se esse atributo é true, subseqüentes tarefas na Target elemento continuar a executar o mesmo se a tarefa atual falha, e todos os erros da tarefa são tratados como avisos.
Parameter	Necessário se a classe da tarefa contém um ou mais propriedades rotulada com o [Required] atributo. Um parâmetro de tarefa definida pelo usuário que contém o valor do parâmetro como seu valor. Pode haver qualquer número de parâmetros no elementoTask , com cada mapeamento de atributos para um.NET propriedade em que a classe de tarefa.

Condition

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

ContinueOnError

Atributo opcional. Um atributo booleano, padrões para false se não for especificado. Se ContinueOnError é false e uma falha da tarefa, as tarefas restantes do destino elemento não são executadas e todo o Target elemento é considerado falha.

Se esse atributo é true, subseqüentes tarefas na Target elemento continuar a executar o mesmo se a tarefa atual falha, e todos os erros da tarefa são tratados como avisos.

Parameter

Necessário se a classe da tarefa contém um ou mais propriedades rotulada com o [Required] atributo.

Um parâmetro de tarefa definida pelo usuário que contém o valor do parâmetro como seu valor. Pode haver qualquer número de parâmetros no elementoTask , com cada mapeamento de atributos para um.NET propriedade em que a classe de tarefa.

Elementos filho

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

Elementos pai

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

Comentários

A Task elemento em um MSBuild o arquivo de projeto cria uma instância de uma tarefa, define propriedades sobre ele e executa o proprietário. O Output elemento armazena os parâmetros de saída em propriedades ou os itens a serem usados em outro lugar no arquivo de projeto.

Se houver alguma OnError elementos pai Target elemento de uma tarefa, eles ainda seja avaliados se a tarefa falhar e ContinueOnError tem um valor de false. Para obter mais informações sobre tarefas, consulte Tarefas do MSBuild.

Exemplo

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

Consulte também

Conceitos

Tarefas do MSBuild

Referência de esquema do arquivo de projeto MSBuild

Outros recursos

Referência de tarefa do MSBuild

Partilhar via