كيفية القيام بما يلي: التحقق من صحة التعليمات البرمجية مقابل المخططات الطبقية

ينطبق هذا الموضوع على:

Visual Studio Ultimate	Visual Studio Premium	Visual Studio Professional	Visual Studio Express

التحقق من صحة تعليمات برمجية مقابل مخطط طبقي يساعدك على فرض قيود بنيوية على التعليمات البرمجية أثناء تطورها. عند تنفيذ هذه المهمة, تتم مقارنة التبعيات في التعليمات البرمجية مه التبعيات في المخطط. التحقق الطبقي من الصحة يمكنه أيضاً مساعدتك مع المهام التالية:

• مراجعة الاختلافات بين التعليمات البرمجية الموجودة و التصميم المقترح.

• البحث عن تعليمات برمجية غير منظمة بالشكل المطلوب أو لها تبعيات غير مرغوب بها.

• البحث عن التبعيات التي قد تتأثر بالتغييرات المقترحة.

  على سبيل المثال، يمكنك تحرير المخطط الطبقي لإظهار التغييرات البنيوية المحتملة ثم التحقق من التعليمات البرمجية لمراجعة التبعيات المتأثرة. للمزيد من المعلومات، راجع كيفية القيام بما يلي: إنشاء رسومات تخطيطية طبقيّة من نتائج ملموسة والرسومات التخطيطية الطبقية: إرشادات.

• إعادة هيكلة أو ترحيل التعليمات البرمجية إلى تصميم مختلف.

  البحث عن التعليمات البرمجية أو التبعيات التي لا تزال تتطلب العمل عند نقل التعليمات البرمجية إلى بنية مختلفة.

قبل أن يمكنك التحقق من صحة التعليمات البرمجية, أولاً يجب أن يكون لديك مخطط طبقي يوضح بنية النظام الخاص بك. هذا المخطط ينظّم مساحات الأسماء, و المشاريع, و العناصر الملموسة الأخرى في حل Visual Studio إلى مجموعات منطقية ،أو مجردة أو طبقات. هذه الطبقات تصف المكونات الرئيسية للنظام أو المهام التي تؤديها هذه العناصر الملموسة. يجب عليك تعريف هذه الطبقات، و ربط العناصر الملموسة بها، و وصف التبعيات المقصودة بين تلك العناصر الملموسة.

ملاحظة

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

للحصول على مزيد من المعلومات حول كيفية إنشاء مخططات طبقية، راجع المواضيع التالية:

• كيفية القيام بما يلي: إنشاء رسومات تخطيطية طبقيّة من نتائج ملموسة

• الرسومات التخطيطية الطبقية: إرشادات

• الرسومات التخطيطية الطبقية: المرجع

في هذا الموضوع

• تضمين تجميعات أو مشاريع معينة للتحليل أثناء التحقق من الصحة.

• التحقق من صحة التعليمات البرمجية يدوياً في أي وقت.

• التحقق من صحة التعليمات البرمجية تلقائياً أثناء إنشاء محلي.

• التحقق من صحة التعليمات البرمجية تلقائياً أثناء "إنشاء إدارة فريق" .

تضمين تجميعات أو مشاريع معينة للتحليل أثناء التحقق من الصحة

1. في مستكشف الحلول، انقر يمينا فوق مشروع الطراز أو مجلد مرجع طبقةثم انقر فوق إضافة مرجع.

2. في مربع الحوار إضافة المرجع، حدد التجميعات أو المشاريع, ثم انقر فوق موافق .

التحقق من صحة التعليمات البرمجية يدوياً في أي وقت

للتحقق من صحة التعليمات البرمجية من مخطط طبقي مفتوح

1. انقر يمينا فوق سطح الرسم التخطيطي ثم انقر فوق التحقق من صحة البنية.

   ملاحظة

   افتراضياً، خاصية إنشاء إجراء لملف الرسم التخطيطي الطبقي (.layerdiagram) يتم تعيينها إلى تحقق بحيث يتم تضمين الرسم التخطيطي في عملية التحقق من الصحة.

   نافذة قائمة الأخطاء تقرر أي أخطاء تحدث. للحصول على مزيد من المعلومات حول أخطاء التحقق من الصحة، راجع فهم أخطاء التحقق من صحة الطبقة.

2. لعرض مصدر كل خطأ، انقر نقرًا مزدوجًا فوق الخطأ في نافذة قائمة الأخطاء.

   ملاحظة

   Visual Studio قد يعرض رسم بياني للتبعية بدلاً من مصدر الخطأ. يحدث هذا عندما إما عندما تكون التعليمة البرمجية لها تبعية على تجميع لم يتم تحديده بواسطة رسم تخطيطي طبقي, أو التعليمات البرمجية تفتقد تبعية محددة بواسطة الرسم التخطيطي الطبقي. راجع الرسم البياني للتبعية أو التعليمات البرمجية لتحديد ما إذا كان يجب وجود التبعية. للحصول على مزيد من المعلومات حول رسومات التبعية راجع كيفية القيام بما يلي: استعرض و نقل مستندات الرسم البياني.

3. لإدارة الأخطاء ، راجع إدارة أخطاء التحقق من الصحة.

للتحقق من صحة التعليمات البرمجية من موجه الأوامر

1. افتح موجه أوامر Visual Studio .

   لفتح موجه الأوامر , انقر فوق ابدأ ,ثم أشر الي كافة البرامج ثم اشر الي Microsoft Visual Studio 2010, ثم اشر الي أدوات Visual Studio ثم انقر فوق موجه اوامر Visual Studio 2010.

2. حدد أحد الخيارين التاليين:

   • للتحقق من التعليمات البرمجية مقابل مشروع طراز معين في الحل, قم بتشغيل MSBuild مع الخاصية المخصصة التالية.

     msbuild <FilePath+ModelProjectFileName>.modelproj
     /p:ValidateArchitecture=true
     

     -أو-

     استعرض للوصول إلى المجلد الذي يحتوي على ملف مشروع الطراز (.modelproj) و الرسم التخطيطي الطبقي ثم قم بتشغيل MSBuild مع الخاصية المخصصة التالية:

     msbuild /p:ValidateArchitecture=true 
     

   • للتحقق من التعليمات البرمجية مقابل كل مشاريع الطراز في الحل, قم بتشغيل MSBuild مع الخاصية المخصصة التالية:

     msbuild <FilePath+SolutionName>.sln /p:ValidateArchitecture=true 
     

     -أو-

     استعرض للوصول إلى مجلد الحل الذي يجب أن يحتوي على مشروع الطراز الذي يحتوي على رسم تخطيطي طبقي ثم قم بتشغيل MSBuild مع الخاصية المخصصة التالية:

     msbuild /p:ValidateArchitecture=true
     

   أي أخطاء تحدث سيتم سردها. لمزيد من المعلومات حول MSBuild, راجع MSBuild و المهام MSBuild.

للحصول على مزيد من المعلومات حول فهم أخطاء التحقق من الصحة، راجع فهم أخطاء التحقق من صحة الطبقة.

إدارة أخطاء التحقق من الصحة

قد تحتاج أثناء عملية التطوير لإيقاف بعض التعارضات الي تم الإبلاغ عنها أثناء التحقق من الصحة. على سبيل المثال، قد تحتاج لمنع الأخطاء التي تقوم باستهدافها أو الغير ذات صلة بالسيناريو المعين الخاص بك. عند منع خطأ ، يعد إجراءاً جيداً أن يتم تسجيل عنصر عمل في Team Foundation.

لإنشاء عنصر عمل لخطأ تحقق من الصحة

• في النافذة قائمة الأخطاء , انقر بزر الماوس الأيمن فوق الخطأ وأشر إلى إنشاء عنصر عمل ثم ثم انقر فوق نوع عنصر العمل الذي تريد إنشاؤه.

استخدم هذه المهام لإدارة أخطاء التحقق من الصحة في النافذة قائمة الأخطاء:

لعمل	اتبع الخطوات التالية
امنع الأخطاء المحددة أثناء التحقق من الصحة	انقر يمينا فوق الأخطاء المحددة (واحد أو عدة) ، أشر إلى إدارة أخطاء التحقق من صحةثم انقر فوق منع الأخطاء. الأخطاء الممنوعة تظهر بتنسيق يتوسطه خط. عند تشغيل التحقق من الصحة في المرة القادمة, هذه الأخطاء لن تظهر. يتم تعقب الأخطاء الممنوعة في ملف .suppressions لملف الرسم التخطيطي الطبقي المقابل.
إيقاف منع الأخطاء المحددة	انقر يمينا فوق الخطأ الممنوع المحددة (أو عدة أخطاء) ، أشر إلى إدارة أخطاء التحقق من صحةثم انقر فوق إيقاف منع الأخطاء. الأخطاء الممنوعة المحددة سوف تظهر عند التحقق من الصحة في المرة القادمة.
استعادة كافة الأخطاء الممنوعة في نافذة قائمة الأخطاء	انقر يمينا فوق أي مكان في نافذة قائمة الأخطاء ، أشر إلى إدارة أخطاء التحقق من صحةثم انقر فوق إظهار كافة الأخطاء الممنوعة.
إخفاء كافة الأخطاء الممنوعة من نافذة قائمة الأخطاء	انقر يمينا فوق أي مكان في نافذة قائمة الأخطاء ، أشر إلى إدارة أخطاء التحقق من صحةثم انقر فوق إخفاء كافة الأخطاء الممنوعة.

التحقق من صحة التعليمات البرمجية تلقائياً أثناء إنشاء محلي

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

للتحقق من صحة التعليمات البرمجية تلقائيًا من بناء محلي

• استخدم محرر نص لفتح ملف مشروع الطراز (.modelproj) و قم بتضمين الخاصية التالية:

<ValidateArchitecture>true</ValidateArchitecture>

-أو-

1. في مستكشف الحلول، انقر يمينا فوق مشروع الطراز الذي يحتوي على الرسم التخطيطي الطبقي (أو الرسومات التخطيطية) ثم انقر فوق خصائص.

2. في نافذة خصائص قم بتعيين خاصية المشروع الطراز التحقق من صحة البنية إلى True.

   هذا يتضمن مشروع الطراز في عملية التحقق من الصحة.

3. في مستكشف الحلول ، انقر فوق ملف الرسم التخطيطي الطبقي (.layerdiagram) الذي تريد استخدامه للتحقق.

4. في نافذة الخصائص, تأكد من تعيين خاصية الرسم التخطيطي إنشاء إجراء إلى تحقق.

   يتضمن هذا الرسم التخطيطي الطبقي في عملية التحقق من الصحة.

للحصول على مزيد من المعلومات حول فهم أخطاء التحقق من الصحة، راجع فهم أخطاء التحقق من صحة الطبقة. لإدارة الأخطاء ، راجع إدارة أخطاء التحقق من الصحة.

التحقق من صحة التعليمات البرمجية تلقائياً أثناء "إنشاء إدارة فريق"

قم بتضمين التحقق من الصحة كجزء من البناء التلقائي المعتاد أو بناء الإيداع المبوب للمساعدة في منع الاختيار الإضافية التي تسبب تعارضات مع التصميم المقصود. استخدم تقارير الإنشاء لتجميع هذه الأخطاء. لمزيد من المعلومات حول بنية Team Foundation، راجع المواضيع التالية:

• Overview of Team Foundation Build

• كيفية: تعريف البنية استخدام القالب الافتراضي

• كيفية: تعريف البنية استخدام قالب الترقية

• تعريف للبنيات سير العمل باستخدام قالب عملية إنشاء مخصص

• كيفية: تقدم عملية إنشاء جهاز العرض

للحصول على مزيد من المعلومات حول كيفية استخدام طرق بناء الإيداع, راجع كيفية: تعريف البنية التحقق من صحة التغييرات قبل إيداع.

للتحقق من صحة تعليمات برمجية عند تشغيل "إنشاء أساس الفريق"

1. في مستكشف الفريق , انقر نقراً مزدوجاً فوق تعريف البنية ثم انقر فوق العملية.

2. ضمن معاملات عملية الإنشاء، قم بتوسيع التحويل البرمجيثم اكتب ما يلي في المعامل MSBuild Arguments:

   /p:ValidateArchitecture=true

لمزيد من المعلومات، راجع كيفية: تعريف البنية استخدام القالب الافتراضي.

العناصر الملموسة التي لا تدعم التحقق من الصحة

العناصر الملموسة التي لا تدعم التحقق من الصحة مقابل رسم تخطيطي طبقي تتضمن مستندات Office ,و ملفات نصية عادية, و مشاريع C++. يمكنك ربط مثل هذه العناصر الملموسة بطبقات, طبقات ولكن عملية التحقق من الصحة ستتجاهلها. أخطاء التحقق من الصحة لن تظهر لمراجع المشاريع أو التجميعات التي تم ربطها بطبقات منفصلة عندما لا تظهر أية تبعيات بين تلك الطبقات. لا تعتبر مثل مراجع تبعيات إلا إذا استخدمت التعليمات البرمجية تلك المراجع.

للتحقق من ما إذا كان العنصر الملموس يدعم التحقق من الصحة

1. في المخطط الطبقي, حدد طبقة واحدة أو أكثر, انقر يمينًا فوق التحديد الخاص بك ثم انقر فوق عرض الارتباطات.

2. في مستكشف الطبقات ، انظر للعمود يدعم التحقق من الصحة.

   إذا كانت القيمة false لارتباط عنصر ملموس, فإن ذلك العنصر الملموس لا يدعم التحقق من الصحة.

راجع أيضًا:

المبادئ

التحقق من صحة النظام أثناء التطوير

موارد أخرى

فهم أخطاء التحقق من صحة الطبقة