OnError-Element (MSBuild)

Artikel
06/19/2023

Bewirkt, dass mindestens ein Ziel ausgeführt wird, wenn das ContinueOnError-Attribut für eine Aufgabe, bei der ein Fehler aufgetreten ist, false ist.

Syntax

<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	Beschreibung
`Condition`	Optionales Attribut. Die auszuwertende Bedingung. Weitere Informationen finden Sie unter Conditions (MSBuild-Bedingungen).
`ExecuteTargets`	Erforderliches Attribut. Die Ziele, die ausgeführt werden, wenn bei einer Aufgabe ein Fehler auftritt. Trennen Sie mehrere Ziele durch Semikolons. Mehrere Ziele werden in der angegebenen Reihenfolge ausgeführt.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	Beschreibung
Ziel	Containerelement für MSBuild-Aufgaben.

Hinweise

MSBuild führt das OnError-Element aus, wenn eine der Aufgaben des Target-Elements bei Festlegung des ContinueOnError-Attributs auf ErrorAndStop (oder false) nicht erfolgreich ist. Wenn bei der Aufgabe ein Fehler auftritt, werden die im ExecuteTargets-Attribut festgelegten Ziele ausgeführt. Wenn das Ziel mehrere OnError-Elemente enthält, werden die OnError-Elemente sequenziell ausgeführt, wenn bei der Aufgabe ein Fehler auftritt.

Weitere Informationen zu den ContinueOnError-Attributen finden Sie unter Aufgabenelement (MSBuild). Informationen zu Zielen finden Sie unter Targets.

Beispiel

Der folgende Code führt die TaskOne- und TaskTwo-Aufgabe aus. Wenn es bei TaskOne zu einem Fehler kommt, 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>

Freigeben über