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