Compartilhar via


Elemento OnError (MSBuild)

Faz com que um ou vários destinos executar, se o atributo de ContinueOnError é false para uma tarefa falha.

<OnError ExecuteTargets="TargetName"
    Condition="'String A'=='String B'" />

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.

ExecuteTargets

Atributo necessário.

Destinos para executar uma tarefa se falhar. Destinos separados de vários com ponto-e-vírgula. Os vários destinos são executados na ordem especificada.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

Destino

Elemento contêiner para tarefas de MSBuild .

Comentários

MSBuild executa o elemento de OnError se uma das tarefas de elemento de Target falha com o atributo de ContinueOnError definido como ErrorAndStop (ou a false). Quando a tarefa falhar, destinos especificados no atributo de ExecuteTargets são executados. Se houver mais de um elemento de OnError no destino, os elementos de OnError são executados seqüencialmente quando a tarefa falhar.

Para obter informações sobre o atributo de ContinueOnError , consulte Elemento Task (MSBuild). Para obter informações sobre destinos, consulte Destinos do MSBuild.

Exemplo

O código a seguir executa as tarefas de TaskOne e de TaskTwo . Se TaskOne falhar, MSBuild avalia o elemento de OnError e executa o destino de OtherTarget .

<Target Name="ThisTarget">
    <TaskOne ContinueOnError="ErrorAndStop">
    </TaskOne>
    <TaskTwo>
    </TaskTwo>
    <OnError ExecuteTargets="OtherTarget" />
</Target>

Consulte também

Conceitos

Referência do esquema de arquivos de projeto do MSBuild

Destinos do MSBuild