CA1047: Korumalı türlerde korunan üyeleri bildirmeyin

Makale
02/04/2025

Ö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.

Belirli API yüzeylerini ekleme

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

Aracılığıyla paylaş