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

Siehe auch

Konzepte

Referenz zum MSBuild-Projektdateischema

MSBuild-Ziele