Elemento OnError (MSBuild)

  • Artigo

Faz com que um ou mais destinos sejam executados se o atributo ContinueOnError for false para uma tarefa com falha.

<Projeto><Destino><OnError>

Syntax

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

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.
ExecuteTargets Atributo obrigatório.

Os destinos que serão executados se uma tarefa falhar. Separe vários destinos com ponto e vírgula. Vários destinos são executados na ordem especificada.

Elementos filho

Nenhum.

Elementos pai

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

Comentários

MSBuild executará o elemento OnError se uma das tarefas do elemento Target falhar com o atributo ContinueOnError definido como ErrorAndStop (ou false). Quando a tarefa falhar, os destinos especificados no atributo ExecuteTargets serão executados. Se houver mais de um elemento OnError no destino, os elementos OnError serão executados sequencialmente quando a tarefa falhar.

Para saber mais sobre o atributo ContinueOnError, confira Elemento Task (MSBuild). Para obter mais informações sobre os destinos, consulte Destinos.

Exemplo

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

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

Confira também