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, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
Condition	Optionales Attribut. Die auszuwertende Bedingung. Weitere Informationen hierzu 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	Beschreibungen
Target	Containerelement für MSBuild-Aufgaben.

Hinweise

MSBuild führt das OnError-Element aus, wenn eine der Aufgaben des Target-Elements fehlschlägt und das ContinueOnError-Attribut auf false festgelegt ist. 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. Weitere Informationen 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="false">
    </TaskOne>
    <TaskTwo>
    </TaskTwo>
    <OnError ExecuteTargets="OtherTarget" />
</Target>

Siehe auch

Konzepte

Referenz zum MSBuild-Projektdateischema

MSBuild-Ziele