عنصر مهمة (‏‫MSBuild)

تنشىء و تنفذ مثيل مهمة MSBuild. يتم تحديد اسم العنصر بواسطة اسم المهمة الجاري إنشاؤها.

<Task Parameter1="Value1"... ParameterN="ValueN"
    ContinueOnError="true/false"
    Condition="'String A' == 'String B'" >
    <Output... />
</Task>

السمات والعناصر

تصف المقاطع التالية سمات، عناصر تابعة وعناصر الأصل.

السمات

السمة	الوصف
Condition	السمة الاختيارية الشرط الذي سيتم تقييمه. لمزيد من المعلومات، راجع شروط ‏‫MSBuild.
ContinueOnError	السمة الاختيارية سمة منطقية التي تأخذ قيمة إفتراضية إذا لم يتم تحديد false. إذا ContinueOnError أخذت القيمة false و فشلت المهمة , فإن المهام المتبقية في العنصر Target لن يتم تنفيذها و كل العنصر Target يعتبر عنصر فاشل. إذا كانت هذه السمة true، فإن المهمة اللاحقة في العنصر Target تستمر بالتنفيذ حتى في حالة فشل المهمة الحالية و كل الأخطاء من المهمة يتم معاملتها كتحذيرات.
Parameter	مطلوب إذا فئة المهمة تحتوي على واحد أو أكثر من الخصائص المقترنة مع السمة [Required]. معلمة المهمة المعرفة من قبل المستخدم التي تحتوي قيمة المعلمة كقيمتها. يمكن أن يكون هناك أي عدد من المعلمات في العنصر Task , مع كل سمة ترتبط مع خاصية NET في فئة المهمة.

العناصر التابعة

العنصر	الوصف
الإخراج	تخزن الإخراجات من المهمة في ملف المشروع. قد يكون هناك صفر أو أكثر من عناصر Output في مهمة.

العناصر الأصلية

العنصر	الوصف
الهدف	عنصر الحاوية لمهام MSBuild.

ملاحظات

عنصر Task في ملف المشروع MSBuild يقوم بإنشاء مثيل من مهمة , بتعيين خصائص عليها ويقوم بتنفيذها. العنصر Output يخزن معلمات الإخراج في خصائص أو عناصر لكي يتم استخدامها في مكان آخر في ملف المشروع.

إذا كان هناك أي عناصر OnError في عناصر الأصل Target لمهمة, فإنها سيتم تقييمهم إذا فشلت المهمة و ContinueOnError يحتوي على القيمة false. للحصول على مزيد من المعلومات حول المهام ، راجع مهام ‏‫MSBuild .

مثال

مثال التعليمات البرمجية التالي ينشىء مثيل لفئة Csc task تعين ستة من الخصائص , ثم تنفذ المهمة. بعد التنفيذ , يتم وضع قيمة الخاصية OutputAssembly للكائن في قائمة عنصر باسم FinalAssemblyName.

<Target Name="Compile" DependsOnTarget="Resources" >
    <Csc Sources="@(CSFile)"
          TargetType="library"
          Resources="@(CompiledResources)"
          EmitDebugInformation="$(includeDebugInformation)"
          References="@(Reference)"
          DebugType="$(debuggingType)" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
    </Csc>
</Target>

راجع أيضًا:

المبادئ

مهام ‏‫MSBuild

مرجع مخطط ملف مشروع ‏‫MSBuild

موارد أخرى

مرجع مهمة ‏‫MSBuild