عنصر OnError (MSBuild)
تؤدي إلى تنفيذ هدف واحد أو أكثر, في حال كانت السمة ContinueOnError false لمهمة فاشلة.
<OnError ExecuteTargets="TargetName"
Condition="'String A'=='String B'" />
السمات والعناصر
تصف المقاطع التالية سمات، عناصر تابعة وعناصر الأصل.
السمات
السمة |
الوصف |
|---|---|
Condition |
السمة الاختيارية الشرط الذي سيتم تقييمه. لمزيد من المعلومات، راجع شروط MSBuild. |
ExecuteTargets |
سمة مطلوبة. الأهداف التي سيتم تنفيذها في حالة فشل المهمة. تفصل أهداف متعددة بفواصل منقوطة. يتم تنفيذ أهداف متعددة مثل الترتيب المحدد. |
العناصر التابعة
لا يوجد.
العناصر الأصلية
العنصر |
الوصف |
|---|---|
عنصر الحاوية لمهام MSBuild. |
ملاحظات
MSBuild ينفذ العنصر OnError إذا فشلت واحدة من مهام العنصر Target مع السمة ContinueOnError تعيّن إلى false. عند فشل المهمة , يتم تنفيذ الأهداف المحددة في السمة ExecuteTargets. إذا كان هناك أكثر من عنصر OnError في الهدف ،يتم تنفيذ العناصر OnError بشكل تسلسلي عند فشل المهمة. لمزيد من المعلومات، راجع الأهداف MSBuild.
مثال
التعليمات البرمجية التالية تنفذ المهام TaskOne و TaskTwo . إذا فشل TaskOne , MSBuild تقيّم العنصر OnError و تنفّذ الهدف OtherTarget.
<Target Name="ThisTarget">
<TaskOne ContinueOnError="false">
</TaskOne>
<TaskTwo>
</TaskTwo>
<OnError ExecuteTargets="OtherTarget" />
</Target>