ca1005: تجنب الإفراط معلمات تشغيل الأنواع العامة
TypeName |
AvoidExcessiveParametersOnGenericTypes |
CheckId |
ca1005 |
Category |
Microsoft.تصميم |
تعطيل تغيير |
فصل |
السبب
يحتوي نوع عام مرئي خارجياً المزيد مصنفين معلمات نوع.
وصف القاعدة
مزيد من المعلمات نوع يحتوي على نوع عام، أكثر صعوبة هو لمعرفة وتذكر ما يمثل كل معلمة نوع. هو واضحة غالباً مع معلمة نوع واحد، كما في List<T>، وفي حالات معينة باستخدام نوع معلمتين، كما في Dictionary<TKey, TValue>. إذا كان هناك المزيد مصنفين نوع المعلمات، يصبح الصعوبة جيدة جداً لمعظم المستخدمين، على سبيل المثال، TooManyTypeParameters<T, K, V>في C# أو TooManyTypeParameters(Of T, K, V)في Visual أساسى.
كيف إلى الإصلاح انتهاكات
لإصلاح انتهاكا لهذه قاعدة، قم بتغيير التصميم لاستخدام المزيد مصنفين نوع معلمات.
عند إلى منع التحذيرات
لا تقوم بمنع تحذير من هذه قاعدة إلا إذا كان يتطلب حتما للتصميم المزيد من نوع معلمتين. توفير عام في بناء جملة هو سهلة الفهم واستخدام تقليل الوقت الذي هو لمعرفة وزيادة معدل تبني مكتبات جديدة.
القواعد ذات الصلة
ca1303: لا تمرير القيم الحرفية كمترجم معلمات
ca1000: لا بتعريف الأعضاء ثابتة تشغيل الأنواع العامة
ca1002: لا تعرض القوائم العامة
CA1006: Do not nest generic types in member signatures
ca1004: يجب توفير وظائف عامة معلمة نوع
ca1003: استخدام مثيلات معالج حدث العام
CA1007: Use generics where appropriate