CA1717: Yalnızca FlagsAttribute numaralandırmalarında çoğul adlar olmalıdır

Özellik Değer
Kural Kimliği CA1717
Başlık Yalnızca FlagsAttribute sabit listeleri çoğul adlara sahip olmalıdır
Kategori Adlandırma
Düzeltme bozucu ya da bozmayan olabilir Son Dakika
.NET 10'da varsayılan olarak etkin Hayır
Geçerli diller C# ve Visual Basic

Neden

Enumerasyon adı çoğul bir sözcükle biter ve System.FlagsAttribute özniteliğiyle işaretlenmemiştir.

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ı

Adlandırma kuralları, sayımsallar için çoğul isimlerin, aynı anda birden fazla sayımsal değerin belirtilebileceğini ifade eder. FlagsAttribute derleyicilere, numaralandırma sabitinin üzerinde bit düzeyinde işlemleri etkinleştiren bir bit alanı olarak ele alınması gerektiğini bildirir.

Bir numaralandırmanın tek seferde yalnızca bir değeri belirtilebiliyorsa, numaralandırmanın adı tek bir sözcük olmalıdı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 listeleme FlagsAttribute içermeli 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 bir yazılım kitaplığını öğrenmek için gereken süreyi 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ı tekil bir sözcük yapın veya ekleyin FlagsAttribute.

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

Ad tekil bir sözcükle bitiyorsa kuraldan gelen bir uyarıyı engellemek güvenlidir.

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 CA1717
// The code that's violating the rule is on this line.
#pragma warning restore CA1717

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.CA1717.severity = none

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

Kod çözümleme için konfigüre et

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

api_surface seçeneğini ayarlayarak, bu kuralın erişilebilirliği temelinde kod tabanınızın hangi bölümlerinde çalıştırılacaklarını 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

Not

XXXX CAXXXX bölümünü geçerli kuralın kimliğiyle değiştirin.

Ayrıca bkz.

  • Last updated on