مهام MSBuild
أ بنية النظام الأساسي بحاجة إلى القدرة على ينفذ أي عدد من الإجراءات أثناء بنية العملية. MSBuildيستخدمالمهام إلى تنفيذ هذه الإجراءات. مهمة هو وحدة من تعليمات برمجية التنفيذية المستخدمة بواسطة MSBuildلتنفيذ عمليات الإنشاء بسيط.
المنطق مهمة
MSBuildلا يمكن تنسيق الملف مشروع XML كامل بتنفيذ العمليات التصنيع يشكل، لذا يجب أن يكون ينفذ منطق مهمة خارج ملف مشروع.
يتم تطبيق منطق تنفيذ مهمة.NET فئة الذي يطبق ITaskواجهة، والتي تم تعريفها في Microsoft.Build.Frameworkمساحة الاسم.
الفئة مهمة أيضا بتعريف معلمات إدخال والإخراج المتاحة إلى مهمة في ملف مشروع. يمكن الوصول إلى الجميع القابل للتعيين غير ثابت غير الملخص الخصائص العمومية المعروضة حسب الفئة مهمة في ملف مشروع بواسطة وضع سمة المقابلة مع نفس الاسم تشغيل العنصر مهمة.
يمكنك كتابة المهام الخاصة بك بواسطة كتابة فئة مدار الذي يطبق في ITaskالواجهة. لمزيد من المعلومات، راجع مهمة الكتابة.
تنفيذ مهمة من ملف مشروع
قبل تنفيذ مهمة في ملف مشروع الخاص بك، يجب أولاً تعيين النوع في تجميع الذي يقوم بتنفيذ المهمة إلى اسم المهمة مع العنصر UsingTask. يتيح هذا MSBuildمعرفة مكان إلى ابحث عن منطق تنفيذ مهمة الخاصة بك عند يجدها في ملف مشروع الخاص بك.
إلى تنفيذ إحدى مهام في MSBuildملف مشروع، قم بإنشاء عنصر باستخدام اسم المهمة كتابع Targetالعنصر. If a مهمة accepts معلمات, these are passed كـ السمات of the عنصر.
MSBuild العنصر lists و خصائص can be used كـ معلمات. For مثال, the following تعليمات برمجية calls the MakeDir مهمة و sets the القيمة of the Directories خاصية of the MakeDir كائن يساوي the القيمة of the BuildDir خاصية declared في the السابق مثال.
<Target Name="MakeBuildDirectory">
<MakeDir
Directories="$(BuildDir)" />
</Target>
Tasks can also return معلومات إلى the ملف مشروع, which can be stored في عناصر أو خصائص for later استخدم. For مثال, the following تعليمات برمجية calls the Copy مهمة و stores the معلومات من the CopiedFiles إخراج خاصية في the SuccessfullyCopiedFiles العنصر قائمة.
<Target Name="CopyFiles">
<Copy
SourceFiles="@(MySourceFiles)"
DestinationFolder="@(MyDestFolder)">
<Output
TaskParameter="CopiedFiles"
ItemName="SuccessfullyCopiedFiles"/>
</Copy>
</Target>
مُضمن Tasks
MSBuild ships مع many tasks such كـ نسخ, which النسخ ملفات, MakeDir, which creates directories, و Csc, which compiles #Visual C المصدر تعليمات برمجية ملفات. For a إكمال قائمة of متوفر tasks و usage معلومات, see مرجع MSBuild المهام.