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

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

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

للحصول على معلومات حول خصائص العناصر في الرسومات التخطيطية الطبقية، راجع الرسومات التخطيطية الطبقية: المرجع.

كيفية تصميم أو تحديث التطبيق الخاص بك باستخدام الرسومات التخطيطية الطبقية

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

ملاحظة

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

1. أنشئ رسم تخطيطي طبقي للتطبيق بأكمله, أو طبقة ضمنه.

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

3. اكتشف التبعيات الموجودة بين الطبقات.

4. حرّر الطبقات و التبعيات لإظهار التصميم المحدّث الذي تريد أن تظهره التعليمات البرمجية.

5. صمم المناطق الجديدة من التطبيق الخاص بك بواسطة إنشاء طبقات لتمثيل الكتل أو المكونات البنيوية الأساسية و تعريف التبعيات لإظهار كيفية استخدام كل طبقة للأخرى.

6. حرر تخطيط و مظهر الرسم التخطيطي لتساعدك في المناقشة مع الزملاء.

7. تحقق من صحة التعليمات البرمجية مقابل الرسم التخطيطي الطبقي لتمييز التعارضات بين التعليمات البرمجية و البناء المطلوب.

8. حدّث التعليمات البرمجية لتتوافق مع البنية الجديدة. طوّر و أعد بناء التعليمات البرمجية بشكل متكرر حتى يُظهر التحقق عدم وجود أي تعارض.

9. قم بتضمين التحقق من صحة الطبقة في عملية الإنشاء للتأكد من أن التعليمة البرمجية تستمر في الالتزام بالتصميم.

إنشاء رسم تخطيطي طبقي

1. في القائمة بنية ، انقر فوق مخطط جديد .

2. ضمن قوالب، انقر فوق مخطط طبقي .

3. إسم المخطط .

4. في إضافة إلى مشروع طراز , استعرض ثم حدد مشروع طراز موجود في الحل.

   -أو-

   انقر فوق إنشاء مشروع طراز جديد لإضافة مشروع طراز جديد إلى الحل.

   ملاحظة

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

تعريف طبقات لتمثل المناطق أو المكونات الوظيفية

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

ملاحظة

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

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

كخط إرشاد عام, إذا كانت العناصر الملموسة ذات تبعيات داخلية بشكل كبير, ضعها في نفس الطبقة. إذا كان يمكن تحديث العناصر الملموسة بشكل منفصل, أو استخدامها في تطبيقات منفصلة, ضعها في طبقات مختلفة. للتعرّف على نقوش الطبقات, قم بزيارة موقع "النقوش و الممارسات" في https://go.microsoft.com/fwlink/?LinkId=145794 .

لمزيد من المعلومات، راجع المواضيع التالية:

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

• كيفية القيام بما يلي: البحث عن تعليمات برمجية باستخدام مستكشف هندسة

استخدم المهام التالية لإنشاء طبقات:

لعمل	قم بإجراء هذه الخطوات
إنشاء طبقة لنتيجة ملموسة وحيدة	اسحب النتيجة الملموسة إلى الرسم التخطيطي الطبقي من أي من المصادر التالية: Solution Explorer على سبيل المثال، يمكنك سحب ملفات أو مشاريع. مستكشف البنية على سبيل المثال، يمكنك سحب مساحات اسم ، فئات أو أساليب. لمزيد من المعلومات، راجع كيفية القيام بما يلي: البحث عن تعليمات برمجية باستخدام مستكشف هندسة. رسومات التبعية لمزيد من المعلومات، راجع كيفية القيام بما يلي: توليد رسم بياني مستندات من تعليمات برمجية. تظهر طبقة في الرسم التخطيطي و تكون مرتبطة بتلك النتيجة الملموسة. أعد تسمية الطبقة لتعكس مسؤوليات التعليمات البرمجية أو العناصر الملموسة المقترنة.
إنشاء طبقة واحدة لكافة النتائج الملموسة المحددة	اسحب كافة النتائج الملموسة المحددة إلى الرسم التخطيطي في نفس الوقت. تظهر طبقة في الرسم التخطيطي و تكون مرتبطة بكل مجموعة النتائج الملموسة.
إنشاء طبقة لكل نتيجة ملموسة محددة	اضغط باستمرار المفتاح SHIFT أثناء سحب كافة النتائج الملموسة إلى الرسم التخطيطي الطبقي في نفس الوقت. ملاحظة إذا استخدمت المفتاح SHIFT لتحديد نطاق من العناصر ، حرر المفتاح بعد تحديد النتائج الملموسة.اضغط مع الاستمرار مرة أخرى عندما تقوم بسحب النتائج الملموسة إلى الرسم التخطيطي. تظهر طبقة لكل نتيجة ملموسة في الرسم التخطيطي و تكون مرتبطة بتلك النتيجة الملموسة.
إضافة نتيجة ملموسة إلى طبقة	اسحب النتيجة الملموسة إلى الطبقة.
إنشاء طبقة جديدة غير مرتبطة	في صندوق الأدوات، قم بتوسيع المقطع المخطط الطبقي ثم قم بسحب طبقة إلى الرسم التخطيطي الطبقي. لإضافة طبقات متعددة ، انقر مرتين على الأداة. عند الانتهاء، انقر فوق الأداة المؤشر أو اضغط المفتاح ESC. -أو- انقر يمينًا فوق الرسم التخطيطي الطبقي ، أشر إلى إضافةثم انقر فوق طبقة. على سبيل المثال، يمكنك القيام بذلك لتمثّل جزءاً من التطبيق الذي لم يبدأ تطويره بعد. يعد إجراءاً مفيدا إنشاء تعليمات برمجية لعنصر نائب لمثل هذه الطبقات في مرحلة مبكرة.
إنشاء طبقات متداخلة	اسحب طبقة موجودة إلى طبقة أخرى. -أو- انقر يمينًا على طبقة، أشر إلى إضافةثم انقر فوق طبقة.
إنشاء طبقة جديدة تحتوي على طبقتين موجودتين أو أكثر	حدد الطبقات, انقر يمينًا فوق طبقة محددة ثم انقر فوق تجميع.
تغيير لون طبقة	قم بتعيين الخاصية لون إلى اللون الذي تريده.
تحديد أن النتائج الملموسة المقترنة بطبقة لا يمكن أن تعتمد على مساحات الأسماء المحددة	اكتب مساحات الأسماء في خاصية تبعيات مساحات الأسماء المحظورة الخاصة بالطبقة. استخدم فاصلة منقوطة (;) لفصل مساحات الأسماء.
حدد أن النتائج الملموسة المقترنة بطبقة لا يجب أن تنتمي إلى مساحات الأسماء المحددة	اكتب مساحات الأسماء في خاصية مساحات الأسماء المحظورة الخاصة بالطبقة. استخدم فاصلة منقوطة (;) لفصل مساحات الأسماء.
حدد أن النتائج الملموسة المقترنة بطبقة يجب أن تنتمي لواحد من مساحات الأسماء المحددة	اكتب مساحة الاسم في الخاصية مساحات الأسماء المطلوبة الخاصة بالطبقة. استخدم فاصلة منقوطة (;) لفصل مساحات الأسماء.

إدارة ارتباطات بين الطبقات و النتائج الملموسة

1. في الرسم التخطيطي الطبقي, انقر يمينًا فوق طبقة ثم انقر فوق عرض الارتباطات.

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

2. استخدم المهام التالية لإدارة هذه الارتباطات:

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

اكتشاف التبعيات الموجودة بين الطبقات

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

ملاحظة

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

لإجراء هندسة عكسية لتبعيات موجودة بين الطبقات

• حدد طبقة واحدة أو أكثر, انقر يمينا فوق طبقة محددة ثم انقر فوق إنشاء التبعيات.

بشكل عام، سترى بعض التبعيات التي يجب ألا تكون موجودة. يمكنك تحرير هذه تبعيات لمحاذاتها مع التصميم المقصود.

تحرير الطبقات و التبعيات للإظهار التصميم المقصود

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

لعمل	قم بإجراء هذه الخطوات
حذف تبعية يجب أن لا تكون موجودة	انقر فوق التبعية ، ثم اضغط DELETE .
تغيير أو تقييد اتجاه تبعية	قم بتعيين خاصية اتجاهالخاصة بها.
إنشاء تبعيات جديدة	استخدم الأدوات تبعية و تبعية ثنائية الاتجاه. لرسم تبعيات متعددة، انقر نقراً مزدوجاً فوق الأداة. عند الانتهاء، انقر فوق الأداة المؤشر أو اضغط المفتاح ESC.
تحديد أن النتائج الملموسة المقترنة بطبقة لا يمكن أن تعتمد على مساحات الأسماء المحددة	اكتب مساحات الأسماء في خاصية تبعيات مساحات الأسماء المحظورة الخاصة بالطبقة. استخدم فاصلة منقوطة (;) لفصل مساحات الأسماء.
حدد أن النتائج الملموسة المقترنة بطبقة لا يجب أن تنتمي إلى مساحات الأسماء المحددة	اكتب مساحات الأسماء في خاصية مساحات الأسماء المحظورة الخاصة بالطبقة. استخدم فاصلة منقوطة (;) لفصل مساحات الأسماء.
حدد أن النتائج الملموسة المقترنة بطبقة يجب أن تنتمي لواحد من مساحات الأسماء المحددة	اكتب مساحة الاسم في الخاصية مساحات الأسماء المطلوبة الخاصة بالطبقة. استخدم فاصلة منقوطة (;) لفصل مساحات الأسماء.

تحسين بنية التعليمات البرمجية

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

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

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

تصميم المناطق الجديدة للتطبيق الخاص بك

عند بدء تطوير مشروع جديد أو منطقة جديدة في مشروع جديد, يمكنك رسم طبقات و تبعيات للمساعدة في التعرف على المكونات الرئيسية قبل البدء في تطوير التعليمات البرمجية.

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

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

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

• ليس عليك ربط معظم الفئات و العناصر الملموسة الأخرى بطبقات لأنها تقع في عناصر ملموسة أكبر مثل مساحات الأسماء التي ربطتها مسبقاً بطبقات.

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

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

تحرير تخطيط العرض التقديمي و المناقشة

لمساعدتك في التعرف على الطبقات و التبعيات أو مناقشتها مع أعضاء الفريق, قم بتحرير مظهر وتخطيط الرسم التخطيطي بالطرق التالية:

• تغيير أحجام وأشكال و مواضع الطبقات.

• قم بتغيير ألوان الطبقات و التبعيات.

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

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

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

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

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.

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

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

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

<ValidateArchitecture>true</ValidateArchitecture>

-أو-

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة

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

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

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

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

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

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

تضمين التحقق من صحة طبقة في عملية الإنشاء

لضمان أن التغييرات المستقبلية في التعليمات البرمجية تتوافق مع الرسومات التخطيطية الطبقية, أضف التحقق من صحة الطبقة لعملية الإنشاء القياسية للحل الخاص بك. عند إنشاء أعضاء الفريق الآخرين للحل, أية اختلافات بين التبعيات في التعليمات البرمجية و الرسم التخطيطي الطبقي سيتم الإبلاغ عنها كأخطاء إنشاء.

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

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

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

   /p:ValidateArchitecture=true

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

راجع أيضًا:

المهام

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

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

المبادئ

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