CA1000: Genel türlerde statik üyeleri belirtmeyin

Özellik Değer
Kural Kimliği CA1000
Başlık Genel türlerde statik üyeler belirtmeyin
Kategori Tasarım
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

Genel tür bir static (Shared Visual Basic'te) üyesi içerir.

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

Kural açıklaması

Genel türün bir static üyesi çağrıldığında, tür bağımsız değişkeni tür için belirtilmelidir. Çıkarsama desteklemeyen bir genel örnek üyesi çağrıldığında, üyenin tür bağımsız değişkeni belirtilmelidir. Bu iki durumda tür bağımsız değişkenini belirtmek için söz dizimi, aşağıdaki çağrıların gösterdiği gibi, farklıdır ve kolayca karıştırılabilir.

' Shared method in a generic type.
GenericType(Of Integer).SharedMethod()

' Generic instance method that does not support inference.
someObject.GenericMethod(Of Integer)()

// Static method in a generic type.
GenericType<int>.StaticMethod();

// Generic instance method that does not support inference.
someObject.GenericMethod<int>();

Genellikle, üye çağrıldığında tür bağımsız değişkeninin belirtilmesi gerekmeyecek şekilde önceki iki bildirimin de yapılmasından kaçınılmalıdır. Genel türlerdeki üyeleri çağırmak için kullanılan söz dizimi, genel olmayan türlerdekiyle aynı olur.

İhlalleri düzeltme

Bu kuralın ihlalini düzeltmek için statik üyeyi kaldırın veya bir örnek üyesiyle değiştirin.

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

Bu kuraldan uyarıyı bastırmayın. Genelliklerin anlaşılması ve kullanılmasının kolay olduğu bir söz diziminde sağlanması, öğrenme süresini azaltır ve yeni kütüphanelerin benimsenme oranını artırı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 CA1000
// The code that's violating the rule is on this line.
#pragma warning restore CA1000

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.CA1000.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 (Tasarım) 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