Elemento de tarefa (MSBuild)

Artigo
08/25/2010

Cria e executa uma instância de um MSBuild tarefa. 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 booliano, cujo padrão é false Se não for especificado. If ContinueOnError é false e uma tarefa falhar, as tarefas restantes na Destino elemento não serão executadas e o inteiro Target elemento é considerado falharam. Se este atributo estiver true, sistema autônomo tarefas subseqüentes no Target elemento continuar a executar o mesmo que a tarefa corrente falhar, e todos sistema autônomo erros da tarefa são tratados sistema autônomo avisos.
Parameter	Necessário se a classe de tarefas contém uma ou mais propriedades rotuladas com o [Required] atributo. Um parâmetro de tarefa definida pelo usuário que contém o valor do parâmetro sistema autônomo seu valor. Pode haver qualquer número de parâmetros no Task elemento, com cada mapeamento de atributo para uma propriedade do .NET na classe tarefa.

Condition

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

ContinueOnError

Atributo opcional. Um atributo booliano, cujo padrão é false Se não for especificado. If ContinueOnError é false e uma tarefa falhar, as tarefas restantes na Destino elemento não serão executadas e o inteiro Target elemento é considerado falharam.

Se este atributo estiver true, sistema autônomo tarefas subseqüentes no Target elemento continuar a executar o mesmo que a tarefa corrente falhar, e todos sistema autônomo erros da tarefa são tratados sistema autônomo avisos.

Parameter

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

Um parâmetro de tarefa definida pelo usuário que contém o valor do parâmetro sistema autônomo seu valor. Pode haver qualquer número de parâmetros no Task elemento, com cada mapeamento de atributo para uma propriedade do .NET na classe tarefa.

Elementos filho

Elemento	Descrição
Saída	Armazenamentos de 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 para MSBuild tarefas.

Comentários

A Task elemento em um MSBuild arquivo de projeto cria uma instância de uma tarefa, define propriedades sobre ele e executa-o. The Output elemento armazena parâmetros de saída em propriedades ou os itens a ser usado em outro lugar no arquivo de projeto.

Se houver qualquer OnError elementos no 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 do Tarefa CSC classe, define seis das propriedades 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>