CA1714: Bayrak numaralandırmalarında çoğul adlar olmalıdır
TypeName |
FlagsEnumsShouldHavePluralNames |
CheckId |
CA1714 |
Kategori |
Microsoft.Naming |
Değişiklik kesiliyor |
Bölme |
Neden
Ortak bir numaralandırma yok FlagsAttribute ve adını değil de bir kişinin '.
Kural Tanımı
İle işaretlenmiş türleri FlagsAttribute özniteliği birden fazla değer belirtilebilir gösterir çünkü çoğul adları vardır.Örneğin, haftanın günlerini tanımlayan bir numaralandırma bir uygulamada kullanmak için birden fazla gün belirtebileceğiniz ayarlanmış olabilir.Bu numaralandırma olmalıdır FlagsAttribute ve 'Gün' olarak adlandırılabilir.Belirtilmesi yalnızca tek bir gün sağlar benzer bir numaralandırma özniteliğine sahip olmaz ve olabilir 'Gün' olarak adlandırılır.
Adlandırma kuralları, hedefleyen ortak dil çalışma zamanı kitaplıkları için ortak bir görünüm sağlar.Bu yeni yazılım kitaplıkları için gereklidir ve kitaplığı geliştirme yönetilen kodda uzmanlığa sahip olan kişi tarafından geliştirilmiş olan müşteri güvenini artırır öğrenme eğrisi azaltır.
İhlalleri düzeltmek nasıl
Çoğul bir sözcüğü numaralandırmanın adını yapmak veya kaldırmak FlagsAttribute özniteliği kullanılarak, birden çok numaralandırma değerleri aynı anda belirtilmemelidir.
Uyarıları ne zaman
Adı çoğul bir sözcüktür, ancak, bitmeyen bir ihlali bastırmak güvenlidir 's'.Örneğin, açıklanan birden çok günü numaralandırma daha önce 'DaysOfTheWeek' adlı, bu kuralın ama onun amacı mantığı ihlal ediyor.Bu tür ihlaller suppressd olmalıdır.
İlgili kuralları
CA1027: Numaralandırmaları FlagsAttribute ile işaretle
CA2217: Numaralandırmaları FlagsAttribute ile işaretlemeyin