خصائص MSBuild
الخصائص هي أزواج الاسم-القيمة التي يمكن استخدامها إلى تكوين البنيات. خصائص مفيدة لتمرير قيم إلى المهام، جاري الآن التقييم الشروط، وقيم sإلىring التي يتم الرجوع إليها في ملف مشروع.
تعريف والرجوع إلى خصائص في ملف مشروع
يتم تعريف الخصائص بواسطة إنشاء عنصر ذلك h كـ اسم خاصية كـ تابعا لعنصر PropertyGroup. ل مثال، XML التالي بإنشاء خاصية المسماة BuildDirبقيمة من Build.
<PropertyGroup>
<BuildDir>Build</BuildDir>
</PropertyGroup>
في ملف مشروع، خصائص يتم الرجوع إليها بواسطة باستخدام بناء الجملة $(PropertyName). على سبيل المثال، خاصية في المثال السابق هو المشار إليه باستخدام $ (BuildDir).
قيم خاصية يمكن أن تتغير خلال redefining خاصية. BuildDirخاصية يمكن إعطاء القيمة جديدة بواسطة استخدام XML هذا:
<PropertyGroup>
<BuildDir>Alternate</BuildDir>
</PropertyGroup>
خصائص يتم تقييمها بالترتيب الذي تظهر به في ملف مشروع. القيمة الجديدة ل BuildDirيجب تعريف بعد تعيين القيمة القديمة.
الخصائص المحجوزة
MSBuildبحجز بعض أسماء الخصائص إلى sإلىre على معلومات حول ملف مشروع وMSBuildالثنائيات. هذه خصائص المشار إليها باستخدام المنهج $، تماما مثل أي خاصية غير ذلك. ل مثال، $(MSBuildProjectFile) بإرجاع اسم الملف بالكامل ملف مشروع، بما في ذلك ملحق اسم الملف.
للمزيد من المعلومات، راجع كيفية القيام بما يلي: الإشارة إلى اسم أو الموقع ملف مشروع ومحجوز MSBuild خصائص.
خصائص بيئة
يمكنك الرجوع إلى متغيرات بيئة في ملفات مشروع تماما كـ الرجوع إلى خصائص محجوز. على سبيل المثال، إلى استخدام PATHمتغير بيئة في ملف مشروع الخاص بك، استخدم $ (مسار). إذا كان مشروع يحتوي على تعريف خاصية له نفس الاسم كإحدى خصائص بيئة، تجاوز الخاصية في مشروع القيمة متغير البيئة. لمزيد من المعلومات، راجع كيفية القيام بما يلي: استخدام متغيرات بيئة في بنية.
خصائص السجل
يمكنك قراءة نظام قيم السجل باستخدام بناء الجملة التالي, الموقع Hiveهو خلية التسجيل (ل مثال، HKEY_LOCAL_MACHINE)، Keyهو اسم المفتاح، SubKeyهو اسم مفتاح فرعي، و Value القيمة في مفتاح فرعي.
$(registry:Hive\MyKey\MySubKey@Value)
إلى الحصول على القيمة مفتاح فرعي الافتراضي، قم بحذف Value.
$(registry:Hive\MyKey\MySubKey)
يمكن أن يتم استخدام القيمة السجل إلى يهيّئ خاصية بنية. على سبيل المثال، إلى إنشاء خاصية بنية التي تمثل الصفحة الرئيسية Visual Studio مستعرض ويب، استخدم تعليمات برمجية:
<PropertyGroup>
<VisualStudioWebBrowserHomePage>
$(registry:HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\WebBrowser@HomePage)
</VisualStudioWebBrowserHomePage>
<PropertyGroup>
خصائص عمومي
MSBuildلك التعيين الخصائص على سطر الأوامر باستخدام**/property**(أو**/p**) تبديل. هذه عمومي يمنع قيم الخصائص قيم الخصائص التي تم تعيينها في ملف مشروع. يتضمن خصائص بيئة، ولكن لا يتضمن خصائص محجوزة ولا يمكن تغييرها.
يقوم المثال التالي بتعيين Configurationخاصية العمومية DEBUG.
msbuild.exe MyProj.proj /p:Configuration=DEBUG
خصائص عمومي يمكن أيضا تعيين أو تعديلها للمشاريع التابعة في بنية multi-مشروع باستخدام Propertiesالسمة الخاصة بالمهمة MSBuild. لمزيد من المعلومات، راجع المهام MSBuild.
خاصية دالات
في إطار عمل.NET الإصدار 4، يمكنك استخدام خاصية إلى تقييم برامج نصية MSBuild. يمكن قراءة وقت النظام، يقارن السلاسل، تطابق تعابير عادية وتنفيذ العديد من غير ذلك الإجراءات ضمن برنامج نصي للإنشاء الخاصة بك بدون استخدام مهام MSBuild.
يمكنك استخدام الوظائف السلسلة (مثيل) إلى تعمل تشغيل أية القيمة خاصية، ويمكنك استدعاء وظائف ثابتة للعديد من فئات النظام. على سبيل المثال، يمكنك تعيين خاصية بنية إلى التاريخ إلى اليوم كما يلي.
<Today>$([System.DateTime]::Now.ToString("yyyy.MM.dd"))</Today>
للحصول على مزيد من المعلومات، و قائمة الدالات الخصائص، راجع خاصية دالات.
إنشاء خصائص أثناء تنفيذ
خصائص وضع خارج Targetتعيين عناصر قيم أثناء مرحلة التقييم بنية. أثناء phكـe التنفيذ اللاحقة، خصائص يمكن تاريخ الإنشاء أو تعديل كـ التالي:
يمكن أن تصدر خاصية بواسطة أي مهمة. إلى خاصية الإرسال، يجب أن يكون العنصر المهام إخراج عنصر فرع له PropertyNameالسمة.
يمكن أن تصدر خاصية بواسطة مهمة CreateProperty. Th هو استخدام هو مهمل.
Startفيg في 3.5 إطار عمل.NET, Targetعناصر قد conta في PropertyGroupالعناصر التي قد conta في تعريفات خاصية.
تخزين XML في خصائص
يمكن أن تتضمن خصائص XML عشوائية، والتي تساعد في تمرير قيم إلى المهام أو عرض معلومات التسجيل. يظهر المثال التالي ConfigTemplateخاصية على القيمة الذي يحتوي على XML و مراجع خاصية الأخرى. MSBuildاستبدال مراجع خاصية باستخدام الخاصة بهم قيم خاصية. يتم تعيين قيم الخصائص بالترتيب الذي تظهر فيه. ولذلك، في هذا مثال، $(MySupportedVersion)، $(MyRequiredVersion)، و $(MySafeMode)يجب أن تم مسبقاً تعريف.
<PropertyGroup>
<ConfigTemplate>
<Configuration>
<Startup>
<SupportedRuntime
ImageVersion="$(MySupportedVersion)"
Version="$(MySupportedVersion)"/>
<RequiredRuntime
ImageVersion="$(MyRequiredVersion)
Version="$(MyRequiredVersion)"
SafeMode="$(MySafeMode)"/>
</Startup>
</Configuration>
</ConfigTemplate>
</PropertyGroup>
راجع أيضًا:
المهام
كيفية القيام بما يلي: استخدام متغيرات بيئة في بنية
كيفية القيام بما يلي: الإشارة إلى اسم أو الموقع ملف مشروع
كيفية القيام بما يلي: بنية ملفات مصدر تماما مع الخيارات المختلفة