Aracılığıyla paylaş

CA1000: Genel türlerde statik üyeleri belirtme

  • Makale
Özellik Değer
Kural Kimliği CA1000
Başlık Genel türlerde statik üyeler belirtme
Kategori Tasarım
Hataya neden olan veya bozulmayan düzeltme Yeni
.NET 9'da varsayılan olarak etkin Hayır

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. Destek çıkarımı desteklenmeyen genel örnek üyesi çağrıldığında tür bağımsız değişkeni üye için belirlenmelidir. Aşağıdaki çağrıların gösterdiği gibi, bu iki durumda tür bağımsız değişkenini belirtmek için söz dizimi farklıdır ve kolayca karıştırılır:

' 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 bildirimlerin her ikisi de önlenmelidir. Bu, genel olmayanların söz diziminden farklı olmayan genel türlerdeki üyeleri çağırmaya yönelik bir söz dizimine neden 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. Genel değerlerin anlaşılması ve kullanımı kolay bir söz diziminde sağlanması, öğrenmesi gereken süreyi azaltır ve yeni kitaplıkların benimseme 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 none olarak ayarlayın.

[*.{cs,vb}]
dotnet_diagnostic.CA1000.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 (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

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.