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 8'de varsayılan olarak etkin Öneri olarak

Neden

Genel tür (NotInheritable Visual basic'te) ve sealed 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

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

Örnek

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

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

Public NotInheritable Class BadSealedType
    Protected  Sub MyMethod
    End Sub
End Class