CA1714: Bayrak numaralandırmalarında çoğul adlar olmalıdır

  • Makale
Özellik Değer
Kural Kimliği CA1714
Başlık Bayrak sabit listeleri çoğul adlara sahip olmalıdır
Kategori Adlandırma
Hataya neden olan veya bozulmayan düzeltme Yeni
.NET 8'de varsayılan olarak etkin Hayır

Neden

Bir numaralandırmada System.FlagsAttribute ve adı 's' ile bitmiyor.

Varsayılan olarak, bu kural yalnızca dışarıdan görünen numaralandırmalara bakar, ancak bu yapılandırılabilir.

Kural açıklaması

özniteliği birden fazla değerin belirtilebileceğini gösterdiğinden, ile FlagsAttribute işaretlenmiş türlerin çoğul adları vardır. Örneğin, haftanın günlerini tanımlayan bir numaralandırma, birden çok gün belirtebileceğiniz bir uygulamada kullanıma yönelik olabilir. Bu numaralandırmada FlagsAttribute ve bulunmalıdır ve 'Days' olarak adlandırılabilir. Yalnızca tek bir günün belirtilmesine izin veren benzer bir numaralandırma özniteliğine sahip değildir ve 'Day' olarak adlandırılabilir.

Adlandırma kuralları, ortak dil çalışma zamanını hedefleyen kitaplıklar için ortak bir görünüm sağlar. Bu, yeni yazılım kitaplıkları için gereken öğrenme eğrisini azaltır ve kitaplığın yönetilen kod geliştirme konusunda uzmanlığı olan biri tarafından geliştirildiğine dair müşteri güvenini artırır.

İhlalleri düzeltme

Numaralandırmanın adını çoğul bir sözcük yapın veya aynı anda birden çok numaralandırma değeri belirtilmemesi gerekiyorsa özniteliğini kaldırın FlagsAttribute .

Uyarıların ne zaman bastırılması gerekiyor?

Ad çoğul bir sözcükse ancak 's' ile bitmediyse ihlali bastırmak güvenlidir. Örneğin, daha önce açıklanan birden çok günlük sabit listesi 'DaysOfTheWeek' olarak adlandırılmışsa, bu kuralın mantığını ihlal eder ancak amacını ihlal etmeyecektir. Bu tür ihlaller bastırılmalıdır.

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

#pragma warning disable CA1714
// The code that's violating the rule is on this line.
#pragma warning restore CA1714

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

[*.{cs,vb}]
dotnet_diagnostic.CA1714.severity = none

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Çözümlemek için kod yapılandırma

Bu kuralın kod tabanınızın hangi bölümlerinde çalıştırılacaklarını yapılandırmak için aşağıdaki seçeneği kullanın.

Bu seçeneği yalnızca bu kural, geçerli olduğu tüm kurallar veya bu kategorideki (Adlandırma) tüm kurallar için yapılandırabilirsiniz. Daha fazla bilgi için bkz . Kod kalitesi kuralı yapılandırma seçenekleri.

Belirli API yüzeylerini ekleme

Bu kuralın üzerinde çalıştırılacak kod tabanınızın hangi bölümlerini erişilebilirliklerine göre yapılandırabilirsiniz. Örneğin, kuralın yalnızca genel olmayan API yüzeyinde çalıştırılması gerektiğini belirtmek için projenizdeki bir .editorconfig dosyasına aşağıdaki anahtar-değer çiftini ekleyin:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Ayrıca bkz.