OnError-Element (MSBuild)
Bewirkt, dass ein oder mehrere Ziele ausgeführt werden, wenn das ContinueOnError-Attribut für eine fehlgeschlagene Aufgabe den Wert false aufweist.
<OnError ExecuteTargets="TargetName"
Condition="'String A'=='String B'" />
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Description |
|---|---|
Condition |
Optionales Attribut. Die auszuwertende Bedingung.Weitere Informationen finden Sie unter MSBuild-Bedingungen. |
ExecuteTargets |
Erforderliches Attribut. Die Ziele, die ausgeführt werden sollen, wenn eine Aufgabe fehlschlägt.Trennen Sie mehrere Ziele durch Semikolons voneinander.Mehrere Ziele werden in der angegeben Reihenfolge ausgeführt. |
Untergeordnete Elemente
Keine.
Übergeordnete Elemente
Element |
Description |
|---|---|
Containerelement für MSBuild-Aufgaben. |
Hinweise
MSBuild führt das OnError-Element aus, wenn eine der Aufgaben Target-Elements mit dem - Attribut ContinueOnError fehlschlägt, das zu ErrorAndStop festgelegt wird (oder zu false).Wenn die Aufgabe fehlschlägt, werden die im ExecuteTargets-Attribut angegebenen Ziele ausgeführt.Enthält das Ziel mehrere OnError-Elemente, werden die OnError-Elemente sequenziell ausgeführt, wenn die Aufgabe fehlschlägt.
Informationen zum ContinueOnError-Attribut, finden Sie unter Task-Element (MSBuild).Weitere Informationen zu Zielen, finden Sie unter MSBuild-Ziele.
Beispiel
Mit dem folgenden Code werden die TaskOne-Aufgabe und die TaskTwo-Aufgabe ausgeführt.Wenn TaskOne fehlschlägt, wertet MSBuild das OnError-Element aus und führt das OtherTarget-Ziel aus.
<Target Name="ThisTarget">
<TaskOne ContinueOnError="ErrorAndStop">
</TaskOne>
<TaskTwo>
</TaskTwo>
<OnError ExecuteTargets="OtherTarget" />
</Target>