CA1047: Korumalı türlerde korunan üyeleri bildirmeyin

Özellik Değer
Kural Kimliği CA1047
Başlık Sealed türlerde korumalı üyeler bildirmeyin
Kategori Tasarım
Düzeltme bozucu ya da bozmayan olabilir Kesintisiz
.NET 10'da varsayılan olarak etkin Öneri olarak
Geçerli diller C# ve Visual Basic

Neden

Genel bir tür sealed (Visual Basic'te NotInheritable), korumalı bir üye 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, türetilen türlerin bu üyeye erişebilmesi veya onu geçersiz kılabilmesi için korunan üyeleri bildirir. Tanım gereği, mühürlü bir türden devralamazsınız, yani mühürlü 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.

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.

Ö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
  • Last updated on