مشاركة عبر

خصائص ‏‫MSBuild المحجوزة

  • مقالة

MSBuild توفر مجموعة من الخصائص المحجوزة التي تقوم بتخزين معلومات حول ملف المشروع و الثنائيات MSBuild. يتم تقييم هذه الخصائص بنفس طريقة تقييم خصائصMSBuild. على سبيل المثال، لاستخدام الخاصية MSBuildProjectFile , أكتب:

$(MSBuildProjectFile)

الخصائص المحجوزة

يصف الجدول التالي الخصائص المحجوزة MSBuild.

الخصائص

الوصف

MSBuildProjectDirectory

المسار المطلق للدليل حيث يقع ملف المشروع ، على سبيل المثال , C:\MyCompany\MyProduct.

MSBuildProjectFile

إسم المشروع الكامل، بما في ذلك ملحق اسم الملف , على سبيل المثال، MyApp.proj.

MSBuildProjectExtension

ملحق إسم ملف المشروع، بما في ذلك ملحق المدة , على سبيل المثال، proj..

MSBuildProjectFullPath

المسار المطلق و اسم ملف المشروع الكامل, على سبيل المثال، C:\MyCompany\MyProduct\MyApp.proj.

MSBuildProjectName

إسم ملف المشروع بدون ملحق الإسم , على سبيل المثال , MyApp.

MSBuildBinPath

المسار المطلق للمجلد حيث توجد الثنائيات MSBuild التي يتم استخدامها حالياً على سبيل المثال، C:\Windows\Microsoft.Net\Framework\v2.0. هذه الخاصية مفيدة إذا كان عليك الإشارة إلى ملفات في الدليل MSBuild.

MSBuildProjectDefaultTargets

قائمة كاملة من الأهداف المحددة في السمة DefaultTargets للعنصر Project. على سبيل المثال، عنصر Project التالي قد يحتوي على خاصية MSBuildDefaultTargets بقيمة A;B;C.

<Project DefaultTargets="A;B;C" >

MSBuildExtensionsPath

المجلد الفرعي MSBuild ضمن المجلد \Program Files\ أو \Program Files x86 . هذا المسار دوماً يشير إلى "ملفات البرنامج" ذات نفس تقييم بالبت للنافذة التي تستخدمها حالياً. على سبيل المثال، لنافذة 32 بت على جهاز 64 بت , المسار إلى مجلد Program Files x86. لنافذة 64 بت على جهاز 64 بت , المسار هو إلى مجلد Program Files . راجع أيضاً MSBuildExtensionsPath32 و MSBuildExtensionsPath64.

هذا الموقع هو مكان مفيد لوضع ملفات هدف مخصّصة. على سبيل المثال، ملفات الهدف الخاصة بك يمكنك تثبيتها على \Program Files\MSBuild\MyFiles\Northwind.targets ثم إسيرادها في ملفات المشروع عن طريق إستخدام XML التالي.

<Import Project="$(MSBuildExtensionsPath)\MyFiles\Northwind.targets"/>

Note   يمكنك تعيين متغير البيئة MSBUILDLEGACYEXTENSIONSPATH إلى القيمة غير null لتمكين سلوك MSBuildExtensionsPath في الإصدارات السابقة.

MSBuildExtensionsPath32

المجلد الفرعي MSBuild ضمن المجلد \Program Files\ أو \Program Files x86 . يشير هذا مسار دوماً إلى مجلد 32bit Program Files . على سبيل المثال، على جهاز ٣٢ بت , المسار هو إلى مجلد Program Files. لجهاز 64 بت , المسار هو إلى مجلد x86) Program Files) . راجع أيضاً MSBuildExtensionsPath و MSBuildExtensionsPath64.

MSBuildExtensionsPath64

المجلد الفرعي MSBuild ضمن المجلد \Program Files\. يشير هذا مسار دوماً إلى مجلد 64bit Program Files . على جهاز 64-بت. لجهاز 32 بت , هذا المسار فارغ. راجع أيضاً MSBuildExtensionsPath و MSBuildExtensionsPath32.

MSBuildStartupDirectory

المسار المطلق للمجلد حيث يتم إستدعاء MSBuild.

يتيح هذا إمكانية الإنتقال إلى أي نقطة في شجرة مشروع و بناء كل شئ أسفل تلك النقطة دون الحاجة إلى إنشاء ملفات من النوع "dirs.proj" في كل دليل. بدلاً من ذلك، لديك مشروع واحد فقط , كما هو موضح في هذا المثال بإسم c:\traversal.proj :

<Project …>
    <ItemGroup>
        <ProjectFiles  
           Include="$
           (MSBuildStartupDirectory)
           **\*.csproj"/>
    </ItemGroup>
    <Target Name="build">
        <MSBuild    
        Projects="@(ProjectFiles)"/>
    </Target>
</Project>

للبناء عند أي نقطة في الشجرة , عليك كتابة:

msbuild c:\traversal.proj

راجع أيضًا:

المبادئ

خصائص ‏‫MSBuild

موارد أخرى

مرجع ‏‫MSBuild