CA1047: Korumalı türlerde korunan üyeleri bildirmeyin
Ö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