OnError 項目 (MSBuild)
對於一項失敗的工作,如果 ContinueOnError 屬性 (Attribute) 為 false,則會執行一或多個目標 (Target)。
<OnError ExecuteTargets="TargetName"
Condition="'String A'=='String B'" />
屬性和項目
下列各節將說明屬性、子項目和父項目。
屬性
屬性 |
描述 |
---|---|
Condition |
選擇性屬性。 要評估的條件。 如需詳細資訊,請參閱 MSBuild 條件。 |
ExecuteTargets |
必要的屬性。 如果工作失敗便會執行的目標。 以分號分隔多個目標。 多個目標會依照指定的順序執行。 |
子項目
無。
父項目
項目 |
描述 |
---|---|
MSBuild 工作的容器項目。 |
備註
如果 Target 項目的其中一個工作失敗,而且 ContinueOnError 屬性設為 false,則 MSBuild 會執行 OnError 項目。 當工作失敗時,便會執行 ExecuteTargets 屬性所指定的目標。 如果目標中有一個以上的 OnError 項目,當工作失敗時便會依序執行 OnError 項目。 如需詳細資訊,請參閱 MSBuild 目標。
範例
下列程式碼執行 TaskOne 和 TaskTwo 工作。 如果 TaskOne 失敗,MSBuild 便會評估 OnError 項目並執行 OtherTarget 目標。
<Target Name="ThisTarget">
<TaskOne ContinueOnError="false">
</TaskOne>
<TaskTwo>
</TaskTwo>
<OnError ExecuteTargets="OtherTarget" />
</Target>