عناصر مشروع ‏‫MSBuild الشائعة

في MSBuild، العنصر عبارة عن مرجع مسمى لملف واحد أو أكثر. تحتوي العناصر على بيانات تعريف مثل أسماء الملفات ومساراتها وأرقام إصدارتها. لدى جميع أنواع المشاريع في Visual Studio عناصر مشتركة متعددة. هذه العناصر معرفة في الملف microsoft.build.commontypes.xsd.

العناصر الشائعة

التالي عبارة عن قائمة لكافة عناصر المشروع الشائعة.

المرجع

يمثل مرجع تجميع (مدار) في المشروع.

اسم سمة العنصر	الوصف
HintPath	سلسلة حرفية اختيارية. المسار المطلق أو النسبي للتجميع.
الاسم	سلسلة حرفية اختيارية. اسم العرض الخاص بالتجميع على سبيل المثال "System.Windows.Forms."
FusionName	سلسلة حرفية اختيارية. تعيّن اسم fusion القوي أو البسيط للعنصر. يتم توفير الوقت في حالة وجود هذه السمة لأنه لا يجب فتح ملف التجميع للحصول على اسم الـ fusion.
SpecificVersion	قيمة منطقية اختيارية. تحدد ما إذا كان يجب الإشارة إلى الإصدار في اسم الـ fusion فقط.
الأسماء المستعارة	سلسلة حرفية اختيارية. أية أسماء مستعارة للمرجع.
Private	قيمة منطقية اختيارية. تحدد ما إذا كان يجب نسخ المرجع إلى مجلد الإخراج.

COMReference

تمثل مرجع مكوّن COM (غير مُدار) في المشروع.

اسم سمة العنصر	الوصف
الاسم	سلسلة حرفية اختيارية. اسم العرض للمكوّن.
Guid	سلسلة حرفية اختيارية. GUID للمكوّن على هيئة {12345678-1234-1234-1234-1234567891234}.
VersionMajor	سلسلة حرفية اختيارية. الجزء الرئيسي لرقم الإصدار للمكوّن. على سبيل المثال، تكون "5" اذا كان رقم الاصدار الكامل هو "5.46."
VersionMinor	سلسلة حرفية اختيارية. الجزء الثانوي لرقم الإصدار للمكوّن. على سبيل المثال، تكون "46" اذا كان رقم الاصدار الكامل هو "5.46."
LCID	سلسلة حرفية اختيارية. LocaleID للمكون.
WrapperTool	سلسلة حرفية اختيارية. اسم أداة التضمين المستخدمة على المكوّن على سبيل المثال "tlbimp."
Isolated	قيمة منطقية اختيارية. تحدد ما إذا كان المكوّن عبارة عن مكوّن لا يتم تسجيله.

COMFileReference

تمثل قائمة من مكتبات أنواع تقوم بتغذية الهدف ResolvedComreference.

اسم سمة العنصر	الوصف
WrapperTool	سلسلة حرفية اختيارية. اسم أداة التضمين المستخدمة على المكوّن على سبيل المثال "tlbimp."

NativeReference

تمثل ملف بيان أصلي أو مرجع لملف.

اسم سمة العنصر	الوصف
الاسم	سلسلة حرفية مطلوبة. الاسم الأساسي لملف البيان.
HintPath	سلسلة حرفية مطلوبة. المسار النسبي لملف البيان.

ProjectReference

تمثل مرجعاً لمشروع آخر.

اسم سمة العنصر	الوصف
الاسم	سلسلة حرفية اختيارية. اسم العرض للمرجع.
Project	سلسلة حرفية اختيارية. GUID للمرجع على هيئة {12345678-1234-1234-1234-1234567891234}.
الحزمة	سلسلة حرفية اختيارية. مسار ملف المشروع المشار إليه.

Compile

يمثل ملفات المصدر للمحول البرمجي.

اسم سمة العنصر	الوصف
DependentUpon	قيمة منطقية اختيارية. تشير إلى ما إذا كان (لتتم الترجمة بشكل صحيح) الملف يعتمد على ملف آخر.
AutoGen	قيمة منطقية اختيارية. تشير إلى ما إذا تم إنشاء الملف للمشروع باستخدام بيئة التطوير المتكاملة (IDE) Visual Studio.
الارتباط	سلسلة حرفية اختيارية. المسار المتعلق بالتدوين ليتم عرضه عندما يكون الملف بالفعل موجود خارج تأثير ملف المشروع.
Visible	قيمة منطقية اختيارية. تشير إلى ما إذا كان يجب عرض الملف في مستكشف الحلول في Visual Studio.
CopyToOutputDirectory	قيمة منطقية اختيارية. القيمة الافتراضية = false. تحدد ما إذا كان سيتم نسخ الملف إلى دليل الإخراج.

EmbeddedResource

تمثل الموارد ليتم تضمينها في التجميع المُنشأ.

اسم سمة العنصر	الوصف
DependentUpon	قيمة منطقية اختيارية. تشير إلى ما إذا كان (لتتم الترجمة بشكل صحيح) الملف يعتمد على ملف آخر.
Generator	سلسلة حرفية مطلوبة. اسم اي مولّد ملف يشتغل على هذا العنصر.
LastGenOutput	سلسلة حرفية مطلوبة. اسم الملف الذي تم إنشاؤه بواسطة أي مولّد ملف يشتغل على هذا العنصر.
CustomToolNamespace	سلسلة حرفية مطلوبة. مساحة الاسم التي يجب على أي مولد ملفات يشتغل على هذا العنصر إنشاء تعليمات برمجية.
الارتباط	سلسلة حرفية اختيارية. المسار المتعلق بالتدوين ليتم عرضه عندما يكون الملف بالفعل موجود خارج تأثير المشروع.
Visible	قيمة منطقية اختيارية. تشير إلى ما إذا كان يجب عرض الملف في مستكشف الحلول في Visual Studio.
CopyToOutputDirectory	قيمة منطقية اختيارية. القيمة الافتراضية = false. تحدد ما إذا كان سيتم نسخ الملف إلى دليل الإخراج.
LogicalName	سلسلة حرفية مطلوبة. الاسم المنطقي للمورد المضمن.

المحتوى

تمثل الملفات التي لم يتم تحويلها برمجياً في المشروع، ولكن قد تكون مضمنة أو يتم نشرها مع المشروع.

اسم سمة العنصر	الوصف
DependentUpon	قيمة منطقية اختيارية. تشير إلى ما إذا سيتم تضمين أو نشر بشكل صحيح الملف الذي يعتمد على ملف آخر.
Generator	سلسلة حرفية مطلوبة. اسم اي مولّد ملفات يشتغل على هذا العنصر.
LastGenOutput	سلسلة حرفية مطلوبة. اسم الملف الذي تم إنشاؤه بواسطة أي مولّد ملفات اشتغل على هذا العنصر.
CustomToolNamespace	سلسلة حرفية مطلوبة. مساحة الاسم التي يجب على أي مولد ملفات يشتغل على هذا العنصر إنشاء تعليمات برمجية.
الارتباط	قيمة منطقية اختيارية. تشير إلى ما إذا كان يجب عرض الملف في مستكشف الحلول في Visual Studio.
PublishState	سلسلة حرفية مطلوبة. حالة نشر المحتوى، إما: Default Included Excluded DataFile المتطلبات الأساسية
IsAssembly	قيمة منطقية اختيارية. تحدد ما إذا كان الملف تجميع.
Visible	قيمة منطقية اختيارية. تشير إلى ما إذا كان يجب عرض الملف في مستكشف الحلول في Visual Studio.
CopyToOutputDirectory	قيمة منطقية اختيارية. القيمة الافتراضية = false. تحدد ما إذا كان سيتم نسخ الملف إلى دليل الإخراج.

لا يوجد

تمثل الملفات التي لا دور لها في عملية البناء.

اسم سمة العنصر	الوصف
DependentUpon	قيمة منطقية اختيارية. تشير إلى ما إذا سيتم تضمين أو نشر بشكل صحيح الملف الذي يعتمد على ملف آخر.
Generator	سلسلة حرفية مطلوبة. اسم اي مولّد ملف يشتغل على هذا العنصر.
LastGenOutput	سلسلة حرفية مطلوبة. اسم الملف الذي تم إنشاؤه بواسطة أي مولّد ملف يشتغل على هذا العنصر.
CustomToolNamespace	سلسلة حرفية مطلوبة. مساحة الاسم التي يجب على أي مولد ملفات يشتغل على هذا العنصر إنشاء تعليمات برمجية.
الارتباط	سلسلة حرفية اختيارية. المسار المتعلق بالتدوين ليتم عرضه عندما يكون الملف بالفعل موجود خارج تأثير المشروع.
Visible	قيمة منطقية اختيارية. تشير إلى ما إذا كان يجب عرض الملف في مستكشف الحلول في Visual Studio.
CopyToOutputDirectory	قيمة منطقية اختيارية. القيمة الافتراضية = false. تحدد ما إذا كان سيتم نسخ الملف إلى دليل الإخراج.

BaseApplicationManifest

تمثل بيان التطبيق الأساسي للإنشاء ويحتوي على معلومات أمان نشر ClickOnce.

CodeAnalysisImport

تمثل مشروع FxCop للاستيراد.

استيراد

تمثل التجميعات التي يجب استيراد مساحات الاسم الخاصة بها بواسطة برنامج التحويل البرمجي لـ Visual Basic.

راجع أيضًا:

المرجع

خصائص مشروع ‏‫MSBuild الشائعة