Aracılığıyla paylaş


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

Ayrıca bkz.

Başvuru

FlagsAttribute

Diğer Kaynaklar

Enumeration Design