مرجع مهمة ‏‫MSBuild

توفر "المهام" تعليمات برمجية يتم تشغيلها أثناء عملية البناء. يفسر هذا القسم المكتبة الخاصة بالمهام الشائعة الموفرة من قبل MSBuild.

بالإضافة إلى المعلّمات المسرودة في المواضيع الموجودة في هذا القسم , كل مهمة لديها المعلّمات التالية:

المعلمة

الوصف

Condition

المعلّمة الإختيارية String.

تعيّن تعبير Boolean الذي يستخدمه المشغّلMSBuild لتحديد ما إذا كان سيتم تشغيل هذه المهمة أم لا. للحصول على معلومات حول الشروط المعتمدة من قبل MSBuild، راجع شروط ‏‫MSBuild.

ContinueOnError

المعلّمة الإختيارية Boolean

القيمة Booleanالتي تحدد ما إذا كانت المهمات الباقية في الهدف ستستمر بالتشغيل في حالة فشل هذه المهمة. المهمة تفشل لأن أسلوب Execute إما يطرح إستثناء أو يرجع false.

إذا تم تعيين ContinueOnError إلى true، المهمات الباقية تعمل و المهمة ااتي تم فشلها لا تتسبب بفشل كل الهدف.

إذا تم تعيين ContinueOnError إلى false، المهمات الباقية لا تعمل و يتم فشل الهدف بأكمله.

بشكل افتراضي، ContinueOnError يكون false.

في هذا القسم

  • مهمة AL (Assembly Linker)
    تنشىء تجميع ببيان من ملف أو أكثر الذي هو إما عبارة عن وحدة نمطية أو ملف مصدر.

  • مهمة AspNetCompiler
    Wraps aspnet_compiler.exe هي أداة مساعدة لإعادة ترجمة تطبيقات ASP.NET.

  • مهمة AssignCulture
    تعيّن معرفات ثقافة إلى العناصر.

  • مهمة CallTarget
    تستدعي هدف في ملف المشروع.

  • مهمة Copy
    تنسخ الملفات إلى موقع جديد.

  • مهمة CreateItem
    تقوم بملأ مجموعات العنصر من عناصر الإدخال , للسماح بنسخ العناصر من قائمة إلى أخرى .

  • مهمة CreateProperty
    تقوم بملأ الخصائص من قيم الإدخال , للسماح بنسخ القيم من سمة أو سلسلة إلى أخرى.

  • مهمة Csc
    استدعاء المحول البرمجي #Visual C لإنتاج الملفات التنفيذية ، مكتبات الإرتباط الديناميكي أو التعليمات البرمجية النمطية.

  • مهمة Delete
    تحذف الملفات المعيّنة.

  • مهمة Error
    يوقف البناء و يسجل خطأ إستناداً إلى عبارة شرطية تم تقييمها.

  • مهمة Exec
    تشغل البرنامج المحدد أو الأمر مع الوسائط المحددة.

  • مهمة FindUnderPath
    تحدّد العناصر المحدّدة في مجموعة العنصر الموجودة في المجلد المحدّد أو المجلدات الفرعية الخاصة به.

  • مهمة GenerateApplicationManifest
    تنشىء بيان التطبيق ClickOnce أو بيان أصلي.

  • مهمة GenerateBootstrapper
    يوفر طريقة تلقائية للكشف عن و تحميل و تثبيت تطبيق و المتطلبات الخاصة به.

  • مهمة GenerateDeploymentManifest
    تنشىء بيان النشرClickOnce.

  • مهمة GenerateResource
    تحول ملفات .txt و .resx إلى ملفات وقت تشغيل اللغة العامة الثنائية resources..

  • مهمة GetAssemblyIdentity
    تسترد هويات التجميع من الملفات المحدّدة و تقوم بإخراج معلومات الهوية.

  • مهمة GetFrameworkPath
    يسترد المسار إلى التجميعات .NET Framework.

  • مهمة GetFrameworkSdkPath
    يسترد المسار إلى عدة تطوير برامج Windows (SDK).

  • مهمة LC
    يقوم بإنشاء ملف license. من ملف licx..

  • مهمة MakeDir
    تنشىء دلائل و عند الضرورة دلائل الأصل.

  • مهمة Message
    يسجل رسالة أثناء عملية البناء.

  • مهمة ‏‫MSBuild
    يبني مشاريع MSBuild من مشروع MSBuild آخر.

  • مهمة ReadLinesFromFile
    تقرأ قائمة من العناصر من ملف نصي.

  • مهمة RegisterAssembly
    تقرأ بيانات التعريف ضمن التجميع المحدّد و تضيف الإدخالات الضرورية إلى السجل.

  • مهمة RemoveDir
    تزيل الدلائل المحدّدة و ملفاتها و دلائلها الفرعية.

  • مهمة ResGen
    تحول ملفات .txt و .resx إلى و من ملفات وقت تشغيل اللغة العامة الثنائية resources..

  • مهمة ResolveAssemblyReference
    يحدّد كل التجميعات التي تعتمد على التجميعات المحدّدة.

  • مهمة ResolveComReference
    تأخذ قائمة أو أكثر من أسماء مكتبة النوع أو ملفات tlb. و تحل مكتبات النوع تلك إلى مواقع على قرص.

  • مهمة ResolveKeySource
    تحدد مصدر رمز الإسم القوي.

  • مهمة ResolveNativeReference
    تعمل هذه المقالة على حل المراجع الأصلية.

  • مهمة SGen
    تنشىء تجميع تسلسل XML لأنواع في التجميع المحدّد.

  • مهمة SignFile
    توقع الملف المحدد باستخدام شهادة محددة.

  • مهمة Touch
    تعيّن أوقات الوصول و التعديلات للملفات.

  • مهمة UnregisterAssembly
    لا تسجل التجميعات المحددة لأغراض توافق COM.

  • مهمة Vbc
    تستدعي المحول البرمجي Visual Basic لإنتاج الملفات التنفيذية ، مكتبات الإرتباط الديناميكي أو التعليمات البرمجية النمطية.

  • مهمة Warning
    يسجل تحذير خلال البناء تبعاً لتقييم عبارة شرطية.

  • مهمة WriteLinesToFile
    يكتب العناصر المحددة إلى ملف النص المحدد.

راجع أيضًا:

المبادئ

مهمة الكتابة

مهام ‏‫MSBuild

موارد أخرى

مرجع ‏‫MSBuild