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

كل مشاريع Visual Studio , بغض النظر عن نوع مشاريعهم , بهم خصائص MSBuild محدّدة شائعة. كما يتم استخدام بعض الخصائص غالباً. التالي هو قائمة من الخصائص الشائعة و المستخدمة غالباً.

قائمة من الخصائص العامة و المعلّمات

إسم الخاصية أو المعلّمة	الوصف
AdditionalLibPaths	تحدّد مجلدات إضافية التي يجب أن يبحث فيها المحوّل البرمجي لتجميعات مرجع.
AddModules	يجعل برنامج التحويل البرمجي يقوم بجعل كل أنواع المعلومات من الملفات المحدّدة متوفرة للمشروع الذي تقوم بترجمته. هذه الخاصية تكافئ مبدّل المحوّل البرمجي /addModules .
ALToolPath	المسار حيث يمكن إيجاد AL.exe. تتجاوز هذه الخاصية الإصدار الحالي من AL.exe لتمكين استخدام إصدار مختلف.
ApplicationIcon	ملف الرمز .ico الذي سيتم تمريره إلى المحول البرمجي لتضمينه كرمز Win32. الخاصية تكافئ مبدّل المحوّل البرمجي /win32icon .
ApplicationManifest	تعيّن مسار الملف الذي يُستخدم لإنشاء معلومات بيان خارجية ل (التحكم في حساب المستخدم) (UAC) . يطبق فقط مشاريع على إستهداف مشاريع ‏‫Visual Studio Windows Vista. في معظم الحالات، يتم تضمين البيان. ومع ذلك، إذا كنت تستخدم Registration Free COM "أو" النشر ClickOnce , إذا البيان يمكن أن يكون ملف خارجي المثبت مع تجميعات التطبيق. لمزيد من المعلومات، راجع خاصية البيان NoWin32 في هذا الموضوع:
AssemblySearchPaths	قائمة بالمواقع للبحث فيها خلال وقت بناء دقة تجميع المرجع. الترتيب الذي تظهر به المسارات في هذه القائمة ذو معنى لأن المسارات المذكورة سابقاً له الأسبقية على الإدخالات الأحدث.
إسم التجميع	اسم تجميع الإخراج النهائي بعد إنشاء المشروع.
BaseAddress	تعيّن العنوان الأساسي لتجميع الإخراج الرئيسي. هذه الخاصية تكافئ مبدّل المحوّل البرمجي /baseaddress .
BaseOutputPath	تحدّد المسار الأساسي لملف الإخراج. في حالة تعيينها , MSBuild سيستخدم OutputPath = $(BaseOutputPath)\$(Configuration)\. بناء جملة المثال : <BaseOutputPath>c:\xyz\bin\</BaseOutputPath>
BaseIntermediateOutputPath	تحدّد المسار المتوسط الأساسي لملف الإخراج. بناء جملة المثال : <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath>
BuildInParallel	قيمة منطقية تشير إلى ما إذا كان يتم إنشاء أو تنظيف مراجع مشروع في نفس الوقت عند إستخدام MSBuild Multi-Proc. القيمة الإفتراضية هي true، مما يعني أنه سيتم بناء المشاريع في نفس الوقت إذا كان النظام يحتوي على العديد من المعالجات أو الأساسيات.
BuildProjectReferences	قيمة منطقية تشير إلى ما إذا تم بناء مراجع المشروع بواسطة MSBuild. عيّنها إلى false إذا كنت تقوم بإنشاء المشروع في بيئة التطوير المتكاملة (IDE) Visual Studio , أو عيّنها إلى true إذا كان خلاف ذلك.
BaseIntermediateOutputPath	المجلد ذو المستوى الأعلى حيث يتم إنشاء كل مجلدات الإخراج المتوسطة ذات التكوين المخصّص. القيمة الافتراضية هي \obj.
CleanFile	إسم الملف الذي سيستخدم ك "ذاكرة التنظيف المؤقتة". ذاكرة التنظيف المؤقتة هي قائمة من الملفات المتولدة التي سيتم حذفها خلال عملية التنظيف. يتم وضع الملف في مسار الإخراج المتوسط بواسطة عملية البناء. تحدّد هذه الخاصية فقط أسماء الملفات التي لا تحتوي على معلومات مسار.
CodePage	يحدد صفحة التعليمات البرمجية لاستخدامها في كافة ملفات مصادر التعليمات البرمجية في التحويل البرمجي. هذه الخاصية تكافئ مبدّل المحوّل البرمجي /codepage .
CompilerResponseFile	ملف الاستجابة الإختياري الذي يمكن تمريره إلى مهام برنامج التحويل البرمجي.
التكوين	التكوين الذي تقوم بإنشائه , إما "يصحح '' أو "يحرّر".
CscToolPath	مسار csc.exe , برنامج التحويل البرمجي #Visual C .
CustomBeforeMicrosoftCommonTargets	اسم ملف المشروع أو ملف الأهداف المستورد تلقائياً قبل إستيراد الأهداف الشائعة.
DebugSymbols	قيمة منطقية تشير إذا ما تم إنشاء رموز بواسطة البناء. إعداد /p:DebugSymbols=false في خط الأمر يعطّل إنشاء ملفات رموز قاعدة بيانات البرنامج (pdb.).
DefineConstants	يعرّف ثوابت المترجم البرمجي الشرطي. يتم فصل أزواج الرمز / القيمة بفواصل منقوطة ثم تحدّد باستخدام بناء الجملة التالي: symbol1 = value1; symbol2 = value2 الخاصية تكافئ مبدّل المحوّل البرمجي /define .
DefineDebug	قيمة منطقية تشير إذا ما كنت تريد الثابت DEBUG معرّف .
DefineTrace	قيمة منطقية تشير إذا ما كنت تريد الثابت TRACE معرّف .
DebugType	يحدّد مستوى معلومات التصحيح الذي تريد إنشاؤه. القيم الصالحة ".full," , "pdbonly," , "none".
DelaySign	قيمة منطقية تشير إلى ما إذا كنت تريد تأخير توقيع التجميع بدلاً من توقيعه بالكامل.
DisabledWarnings	يمنع التحذيرات المحدّدة. يجب فقط تحديد الجزء الرقمي من معرّف التحذير. يتم فصل التحذيرات المتعدّدة بفواصل منقوطة. تتوافق هذه المعلّمة مع المبدّل /nowarn للمحوّل البرمجي vbc.exe.
DisableFastUpToDateCheck	قيمة منطقية التي تنطبق فقط على Visual Studio. مدير البناء Visual Studioيستخدم عملية تسمى FastUpToDateCheck ليعرف ما إذا كان يجب إعادة بناء المشروع ليبقى على إطلاع بالمستجدات. هذا عملية أسرع من استخدام MSBuild لتحديد هذا. تعيين خاصية DisableFastUpToDateCheck إلى true يتيح لك تجاوز مدير البناء Visual Studio بنية مدير و تفرض عليه استخدام MSBuild لتحديد ما إذا كان المشروع محدّث.
DocumentationFile	إسم الملف المتولّد كملف وثائق XML . هذا الإسم يتضمن اسم الملف و ليس له معلومات مسار.
ErrorReport	تحديد كيفية قيام مهمة المحوّل البرمجي بإرسال تقرير عن أخطاء برنامج التحويل البرمجي الداخلية. القيم الصالحة ".prompt," , "send," , "none" هذه الخاصية تكافئ مبدّل المحوّل البرمجي /errorreport .
ExcludeDeploymentUrl	مهمة GenerateDeploymentManifest تضيف علامة deploymentProvider إلى بيان التوزيع إذا ملف المشروع يتضمن أي من العناصر التالية: UpdateUrl InstallUrl PublishUrl استخدام ExcludeDeploymentUrl , على الرغم من ذلك، يمكنك منع إضافة علامة deploymentProvider إلى بيان التوزيع حتى إذا تم تحديد أي من محددات مواقع المعلومات (URL) المذكورة أعلاه. للقيام بذلك، قم بإضافة الخاصية التالية إلى ملف المشروع الخاص بك: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> ملاحظة لم يتم الكشف عن ExcludeDeploymentUrl في IDE Visual Studio ويمكن تعيينها فقط عن طريق تحرير ملف المشروع يدويًا. إعداد هذه الخاصية لا يؤثر على النشر داخل Visual Studio; أي، علامة deploymentProvider مازال سيضاف إلى محدد موقع المعلومات (URL) المحدّد بواسطة PublishUrl.
FileAlignment	تعيّن، بالبايت، أين سيتم محاذاة مقاطع ملف الإخراج. القيم الصحيحة هي 512, 1024, 2048, 4096, 8192. هذه الخاصية تكافئ مبدّل المحوّل البرمجي /filealignment .
FrameworkPathOverride	تحدّد موقع mscorlib.dll و microsoft.visualbasic.dll. تكافىء هذه المعلّمة المبدّل /sdkpath للمحوّل البرمجي vbc.exe.
GenerateDocumentation	معلّمة منطقية تشير إلى ما إذا تم إنشاء الوثائق بواسطة البناء. إذا true، البناء يقوم بإنشاء معلومات وثائق و يضعه في ملف .xml مع اسم الملف التنفيذي أو المكتبة التي أنشأتها مهمة البناء.
IntermediateOutputPath	مسار الإخراج المتوسط الكامل كما لو كان مشتق من BaseIntermediateOutputPath، إذا لم يتم تحديد مسار. على سبيل المثال، \obj\debug\. إذا تم تجاوز هذه الخاصية , فإن تعيين BaseIntermediateOutputPath لن يكون له تأثير.
KeyContainerName	اسم حاوية مفتاح الاسم القوي.
KeyOriginatorFile	اسم ملف مفتاح الاسم القوي.
NoWin32Manifest	يحدّد ما إذا كان المحوّل البرمجي ينشىء بيان Win32 الإفتراضي إلى تجميع الإخراج . القيمة الإفتراضية ل false يعني أنه يتم إنشاء بيان Win32 الإفتراضي لكافة التطبيقات. تكافىء هذه الخاصية مبدّل المحوّل البرمجي /nowin32manifest ل vbc.exe.
ModuleAssemblyName	إسم التجميع الذي سيدمج فيه الوحدة النمطية المترجمة. الخاصية تكافئ مبدّل المحوّل البرمجي /moduleassemblyname .
NoLogo	قيمة منطقية تشير إلى ما إذا كنت تريد إيقاف تشغيل شعار المحوّل البرمجي. هذه الخاصية تكافئ مبدّل المحوّل البرمجي /nologo .
NoStdLib	قيمة منطقية تشير إلى ما إذا كنت تريد تجنب الرجوع إلى المكتبة القياسية (mscorlib.dll). القيمة الافتراضية هي false.
NoVBRuntimeReference	قيمة منطقية تشير إلى ما إذا كان يجب تضمين وقت التشغيل Visual Basic( Microsoft.VisualBasic.dll) كمرجع في المشروع.
NoWin32Manifest	قيمة منطقية تشير إلى ما إذا كان سيتم تضمين معلومات بيان التحكم بحساب المستخدم (UAC) في التطبيق القابل للتنفيذ. يطبق فقط مشاريع على إستهداف مشاريع ‏‫Visual Studio Windows Vista. في المشاريع المنشورة باستخدام ClickOnceو Registration-Free COM , يتم تجاهل هذا العنصر. تعيّن False (القيمة الافتراضية) أن معلومات بيان التحكم بحساب المستخدم (UAC ) مضمّنة في التطبيق القابل للتنفيذ. True يحدّد أن معلومات بيان UAC غير مضمّنة . هذه الخاصية تنطبق فقط على Visual Studio projects targeting Windows Vista. في المشاريع المنشورة باستخدام ClickOnce و Registration-Free COM , يتم تجاهل هذه الخاصية. يجب إضافة NoWin32Manifest فقط إذا كنت لا تريد من Visual Studio أن يضمّن أي معلومات خاصة ببيان الملف القابل للتنفيذ; تسمى هذه العملية virtualization. لاستخدام virtualization , عيّن <ApplicationManifest> بالتزامن مع <NoWin32Manifest> كما يلي: لمشاريع Visual Basic قم بإزالة العقدة <ApplicationManifest>. (في مشاريع Visual Basic , يتم تجاهل <NoWin32Manifest> عند تواجد العقدة <ApplicationManifest> .) لمشاريع #Visual C عيّن <ApplicationManifest> إلى False و <NoWin32Manifest> إلى True. (في مشاريع #Visual C, <ApplicationManifest> يتجاوز <NoWin32Manifest>.)
Optimize	قيمة منطقية عند تعيينها إلى true،فإنها تتيح أمثلية برنامج التحويل البرمجي. هذه الخاصية تكافئ مبدّل المحوّل البرمجي /optimize .
OptionCompare	تحديد كيفية إجراء المقارنات بين السلاسل. القيم الصالحة هي "binary" أو "text." تكافىء هذه الخاصية مبدّل المحوّل البرمجي /optioncompare ل vbc.exe.
OptionExplicit	قيمة منطقية عند تعيينها إلى true، يتطلب تعريف صريح للمتغيرات في التعليمات البرمجية للمصدر. هذه الخاصية تكافئ مبدّل المحوّل البرمجي /optionexplicit .
OptionInfer	قيمة منطقية عند تعيينها إلى true، تمكّن إستنتاج أنواع المتغيرات. هذه الخاصية تكافئ مبدّل المحوّل البرمجي /optioninfer .
OptionStrict	قيمة منطقية عند تعيينها إلى true، يتسبب بجعل مهمة البناء تفرض نوع محدّد إلى تحويلات لأنواع ضمنية. تكافىء هذه الخاصية مبدّل /optionstrict للمحوّل البرمجي vbc.exe.
OutputPath	تحدّد المسار إلى دليل الإخراج , نسبة إلى دليل المشروع , على سبيل المثال , "bin\Debug" .
OutputType	تعيّن تنسيق الملف لملف الإخراج . هذه المعلمة يمكن أن تأخذ واحد من القيم التالية : Library. تنشىء مكتبة من التعليمات البرمجية. القيمة الافتراضية Exe. تنشىء تطبيق وحدة تحكم Module. تنشىء وحدة نمطية. Winexe. تنشىء برنامج يستند إلى Windows. تكافىء هذه الخاصية مبدّل /target للمحوّل البرمجي vbc.exe.
OverwriteReadOnlyFiles	قيمة منطقية تشير إلى ما إذا كنت تريد تمكين البناء للكتابة فوق ملفات للقراءة فقط أو إكتشاف خطأ .
PdbFile	اسم ملف pdb. الذي تقوم بإرساله. تكافىء هذه الخاصية مبدّل /pdb للمحوّل البرمجي csc.exe.
النظام الأساسي	نظام التشغيل الذي تقوم بالبناء من أجله. القيم الصالحة هي ",AnyCPU," "x86" ",‏‫‏‫x64" أو ".‏‫Itanium"
RemoveIntegerChecks	قيمة منطقية تشير إلى ما إذا سيتم تعطيل التحققات من خطأ تجاوز العدد الصحيح . القيمة الافتراضية هي false. تكافىء هذه الخاصية مبدّل /removeintchecks للمحوّل البرمجي vbc.exe.
SGenUseProxyTypes	قيمة منطقية تشير إلى ما إذا كان يجب أن يتم إنشاء أنواع الوكيل بواسطة SGen.exe. الهدف SGen يستخدم هذه الخاصية لتعيين المؤشر UseProxyTypes. القيمة الإفتراضية لهذه الخاصية صواب و لا توجد واجهة مستخدم تغير هذا. لإنشاء تجميع serialization لأنواع ليست webservice , أضف هذه الخاصية إلى ملف المشروع و عيّنه إلى خطأ قبل استيراد Microsoft.Common.Targets أو C#/VB.targets.
SGenToolPath	مسار أدوات اختياري يشير إلى مكان الحصول على SGen.exe عند تجاوز الإصدار الحالي من SGen.exe.
StartupObject	تعيّن الفئة أو الوحدة النمطية التي تحتوي على الأسلوب الرئيسي أو الإجراء الفرعي. هذه الخاصية تكافئ مبدّل المحوّل البرمجي /main .
ProcessorArchitecture	هندسة المعالج المستخدم عندما يتم حل مراجع التجميع. القيم الصالحة هي "msil," "x86," "amd64" أو "ia64."
RootNamespace	مساحة اسم الجذر المستخدم عند تسمية الموارد المضمنة. مساحة الإسم جزء من إسم بيان المورد المضمن.
Satellite_AlgorithmId	معرّف خوارزمية التجزئة AL.exe المستخدمة عند إنشاء تجميعات القمر الصناعي.
Satellite_BaseAddress	العنوان الأساسي المستخدم عند تجميعات culture-specific satellite التي تم إنشاؤها باستخدام الهدف CreateSatelliteAssemblies .
Satellite_CompanyName	اسم الشركة التي سيتم تمريرها في AL.exe أثناء إنشاء تجميع القمر الصناعي.
Satellite_Configuration	اسم التكوين التي سيتم تمريره في AL.exe أثناء إنشاء تجميع القمر الصناعي.
Satellite_Description	نص الوصف الذي سيتم تمريره في AL.exe أثناء إنشاء تجميع القمر الصناعي.
Satellite_EvidenceFile	يضمّن الملف المحدّد في تجميع القمر الصناعي الذي له إسم مورد "Security.Evidence."
Satellite_FileVersion	تحديد سلسلة للحقل <ui>إصدار ملف</ui> في تجميع القمر الصناعي.
Satellite_Flags	تحديد قيمة للحقل Flags في تجميع القمر الصناعي.
Satellite_GenerateFullPaths	تجعل مهمة البناء تستخدم مسارات مطلقة لأي ملفات أصدرت رسالة خطأ.
Satellite_LinkResource	تربط ملفات المورد المحدد إلى تجميع القمر الصناعي.
Satellite_MainEntryPoint	تحدّد إسم الأسلوب المؤهل ( أي class.method ) لاستخدامه كنقطة إدخال عند تحويل وحدة نمطية إلى ملف قابل للتنفيذ أثناء إنشاء تجميع القمر الصناعي .
Satellite_ProductName	تعيّن سلسلة لحقل المنتج في تجميع القمر الصناعي.
Satellite_ProductVersion	تحديد سلسلة لإصدار الحقل في تجميع القمر الصناعي.
Satellite_TargetType	تعيّن تنسيق الملف لملف إخراج تجميع القمر الصناعي كـ "library," , "exe" أو ".win" القيمة الافتراضية هي "library."
Satellite_Title	تعيّن سلسلة لحقل العنوان في تجميع القمر الصناعي.
Satellite_Trademark	تعيّن سلسلة لحقل العلامة التجارية في تجميع القمر الصناعي.
Satellite_Version	تعيّن معلومات الإصدار لتجميع القمر الصناعي.
Satellite_Win32Icon	إدراج ملف رمز .ico في تجميع القمر الصناعي.
Satellite_Win32Resource	تدرج مورد Win32 (ملف .res) في تجميع القمر الصناعي.
TargetCompactFramework	إصدار NET Compact Framework. المطلوب لتشغيل التطبيق الذي تقوم بإنشائه. تحديد هذا يتيح لك الرجوع لتجميعات Framework معينه التي قد لا تتمكن من الرجوع إليها خلاف ذلك.
TargetFrameworkVersion	إصدار .NET Framework المطلوب لتشغيل التطبيق الذي تقوم بإنشائه. تحديد هذا يتيح لك الرجوع لتجميعات Framework معينه التي قد لا تتمكن من الرجوع إليها خلاف ذلك.
TreatWarningsAsErrors	معلمة منطقية التي إذا كانت true، تؤدي إلى معاملة كل التحذيرات كأخطاء. هذه المعلمة تكافئ مبدّل المحوّل البرمجي /nowarn.
UseHostCompilerIfAvailable	معلّمة منطقية التي إذا كانت true، تؤدي إلى جعل مهمة البناء تستخدم كائن المترجم قيد التشغيل في حالة توفره. هذه المعلمة مستخدمة فقط بواسطة Visual Studio.
Utf8Output	معلّمة منطقية التي إذا كانت true، تقوم بتسجيل إخراج المحول البرمجي باستخدام ترميز UTF-8. هذه المعلمة تكافئ مبدّل المحوّل البرمجي /utf8Output.
VbcToolPath	مسار اختياري يشير إلى موقع آخر ل vbc.exe عند تجاوز الإصدار الحالي من vbc.exe.
VbcVerbosity	تعيّن ال verbosity لمخرج برنامج التحويل البرمجي Visual Basic . القيم الصالحة هي" Normal "," Quiet ," , "Verbose " (القيمة الإفتراضية)
WarningsAsErrors	تعيّن قائمة من التحذيرات ليتم معاملتها كأخطاء . هذه المعلمة تكافئ مبدّل المحوّل البرمجي /warnaserror.
WarningsNotAsErrors	تعيّن قائمة من التحذيرات التي لا تعامل على أنها أخطاء. هذه المعلمة تكافئ مبدّل المحوّل البرمجي /warnaserror.
Win32Manifest	اسم ملف البيان الذي يجب تضمينه في التجميع النهائي. هذه المعلمة تكافئ مبدّل المحوّل البرمجي /win32Manifest.
Wint32Resource	اسم ملف مورد Win32 الذي سيضمن في التجميع النهائي. هذه المعلمة تكافئ مبدّل المحوّل البرمجي /win32resource.

راجع أيضًا:

المرجع

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