CA2208: Instantiate argument exceptions correctly
TypeName |
OnlyFlagsEnumsShouldHavePluralNames |
CheckId |
ca1717 |
Category |
Microsoft.Naming |
تعطيل تغيير |
فصل |
السبب
ينتهي الاسم لتعداد مرئي خارجياً الجمع الكلمة ولم يتم وضع علامة التعداد مع System.FlagsAttributeالسمة.
وصف القاعدة
إملاء اصطلاحات التسمية التي اسم جمع قائمة تعداد يشير إلى تلك الالقيمة واحد أو المزيد قائمة تعداد يمكن أن يكون محدداً في نفس الوقت. FlagsAttributeتخبر compilers التي قائمة تعداد يجب معاملتها كحقل بت الذي يسمح بعمليات المختصة بالبت في قائمة تعداد.
إذا كان يمكن تحديد القيمة لتعداد واحد في نفس وقت، يجب أن يكون الاسم الخاص بالتعداد كلمة المفرد. على سبيل المثال، قائمة تعداد التي تعرف أيام أسبوع التي قد تكون موجهة للاستخدام في تطبيق الموقع يمكنك تحديد عدة أيام. وهذا قائمة تعداد يجب أن يكون لديك FlagsAttributeوقد يسمى 'ايام'. قائمة تعداد مشابهة التي تسمح ليوم مفرد فقط إلى يمكن تحديد قد لا يكون لديك السمة، وقد يكون هناك يسمى 'يوم'.
اصطلاحات التسمية يوفر نظرة عامة مكتبات هذا الهدف وقت تشغيل اللغة العامة. وهذا يؤدي إلى تقليل الوقت المستغرق في إلى التعرف على مكتبة البرامج الجديدة، والثقة cusإلىmer يتزايد المكتبة تم تطويره من قبل الشخص الذي لديه خبرة في تطوير تعليمات برمجية المدارة.
كيف إلى الإصلاح انتهاكات
جعل اسم التعداد singular الكلمة أو إضافة FlagsAttribute.
عند إلى منع التحذيرات
هو آمن لمنع ظهور تحذير من قاعدة إذا كان الاسم ينتهي في كلمة المفرد.
القواعد ذات الصلة
CA1714: Flags enums should have plural names
ca1027: وضع علامة تتضمن التعدادات مع FlagsAttribute
ca2217: لا تضع علامة تعدادات مع FlagsAttribute