Élément OnError (MSBuild)

Article
06/19/2023

Provoque l’exécution d’une ou de plusieurs cibles si l’attribut ContinueOnError est défini sur false pour une tâche en échec.

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
`Condition`	Attribut facultatif. Condition à évaluer. Pour plus d’informations, consultez l’article Conditions (Conditions MSBuild).
`ExecuteTargets`	Attribut requis. Les cibles à exécuter si une tâche échoue. Séparez les cibles multiples avec des points-virgules. Les cibles multiples sont exécutées dans l’ordre spécifié.

Éléments enfants

Aucune.

Éléments parents

Élément	Description
Cible	Élément conteneur pour les tâches MSBuild.

Remarques

MSBuild exécute l’élément OnError si l’une des tâches de l’élément Target échoue avec l’attribut ContinueOnError ayant pour valeur ErrorAndStop (ou false). Lorsque la tâche échoue, les cibles spécifiées dans l’attribut ExecuteTargets sont exécutées. S’il existe plusieurs éléments OnError dans la cible, les éléments OnError sont exécutés séquentiellement lorsque la tâche échoue.

Pour plus d’informations sur l’attribut ContinueOnError, voir Élément Task (MSBuild). Pour plus d’informations sur les cibles, consultez l’article MSBuild Targets (Cibles MSBuild).

Exemple

Le code suivant exécute les tâches TaskOne et TaskTwo. Si TaskOne échoue, MSBuild évalue l’élément OnError et exécute la cible OtherTarget.

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

Partager via