مشاركة عبر

عنصر UsingTask (MSBuild)

  • مقالة

تقوم بتعيين المهمة المشار إليها في عنصر Task إلى التجميع الذي يحتوي على تطبيق المهمة.

<UsingTask TaskName="TaskName"
    AssemblyName = "AssemblyName" 
    Condition="'String A'=='String B'" />

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

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

السمات

السمة

الوصف

AssemblyName

إما سمة AssemblyName أو سمة AssemblyFile تكون مطلوبة.

اسم التجميع ليتم تحميله. تقوم سمة AssemblyName بقبول التجميعات ذات الأسماء القوية على الرغم من أنه غير مطلوب. استخدام هذه السمة يكافئ تحميل تجميع بواسطة أسلوب Load في .NET Framework.

لا يمكنك استخدام هذه السمة إذا تم استخدام السمة AssemblyFile.

AssemblyFile

إما سمة AssemblyName أو سمة AssemblyFile تكون مطلوبة.

مسار ملف التجميع. تقبل هذه السمة كلاً من المسارات الكاملة والمسارات النسبية. تكون المسارات النسبية نسبة إلى دليل ملف المشروع أو ملف الأهداف حيث تم الإعلان عن عنصر UsingTask. استخدام هذه السمة يكافئ تحميل تجميع بواسطة أسلوب LoadFrom في .NET Framework.

لا يمكنك استخدام هذه السمة إذا تم استخدام السمة AssemblyName.

TaskName

سمة مطلوبة.

اسم المهمة للإشارة إليها من التجميع. في حالة احتمال وجود أي غموض يجب دوماً تحديد هذه السمة مع مساحات أسماء كاملة. إذا كان هناك غموض يقوم MSBuild باختيار تطابق عشوائي قد يؤدي إلى حدوث نتائج غير متوقعة.

Condition

السمة الاختيارية

الشرط الذي سيتم تقييمه. لمزيد من المعلومات، راجع شروط ‏‫MSBuild.

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

لا يوجد.

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

العنصر

الوصف

Project

العنصر الجذري المطلوب في ملف المشروع MSBuild.

ملاحظات

يمكن الإشارة إلى متغيرات البيئة وخصائص سطر الأوامر وخصائص مستوى المشروع في أي مكان داخل عنصر UsingTask طالما تظهر داخل ملف المشروع إما بوضوح أو بواسطة ملف مشروع تم استيراده. لمزيد من المعلومات، راجع مهام ‏‫MSBuild.

ملاحظةملاحظة

ليس لخصائص مستوى المشروع أي معنى إذا أتى عنصر UsingTask من أحد ملفات .tasks التي تم تسجيلها بشكل عام بمشغل MSBuild.هذه الخصائص ليست عمومية لـ MSBuild.

مثال

يظهر المثال التالي كيفية استخدام عنصر UsingTask مع سمة AssemblyName.

<UsingTask TaskName="Microsoft.Build.Tasks.Csc"
              AssemblyName="Microsoft.Build.Tasks" />

يظهر المثال التالي كيفية استخدام عنصر UsingTask مع سمة AssemblyFile.

<UsingTask TaskName="Email"
              AssemblyFile="c:\myTasks\myTask.dll" />

راجع أيضًا:

المبادئ

مهام ‏‫MSBuild

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

موارد أخرى

مرجع مهمة ‏‫MSBuild