İngilizce dilinde oku

Aracılığıyla paylaş

CA1047: Korumalı türlerde korunan üyeleri bildirmeyin

  • Makale
Özellik Değer
Kural Kimliği CA1047
Başlık Sealed türlerde protected üyeler bildirmeyin
Kategori Tasarım
Hataya neden olan veya bozulmayan düzeltme Hataya neden olmayan
.NET 9'da varsayılan olarak etkin Öneri olarak

Neden

Genel tür (sealed Visual basic'te) ve NotInheritable korumalı bir üyeyi veya korumalı iç içe türü bildirir. Bu kural, bu deseni izlemesi gereken yöntemler için Finalize ihlalleri bildirmez.

Kural açıklaması

Türler, devralmasına erişebileceğiniz veya üyeyi geçersiz kılmak için korunan üyelerin türlerini bildirir. Tanım gereği, korumalı bir türden devralamazsınız, yani korumalı türlerdeki korumalı yöntemler çağrılamaz.

C# derleyicisi bu durum için CA1047 yerine cs0628 uyarısını yayar.

İhlalleri düzeltme

Bu kuralın ihlalini düzeltmek için üyenin erişim düzeyini özel olarak değiştirin veya türü devralınabilir hale getirin.

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

Bu kuraldan uyarıyı bastırmayın. Türün geçerli durumunda bırakılması bakım sorunlarına neden olabilir ve herhangi bir avantaj sağlamaz.

Çö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

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:

ini 
dotnet_code_quality.CAXXXX.api_surface = private, internal

Not

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

Örnek

Aşağıdaki örnekte bu kuralı ihlal eden bir tür gösterilmektedir.

C# 
public sealed class SealedClass
{
    protected void ProtectedMethod(){}
}