CA1047: Nedeklarujte chráněné členy v zapečetěných typech
Vlastnost | Hodnota |
---|---|
ID pravidla | CA1047 |
Název | Nedeklarujte chráněné členy v zapečetěných typech |
Kategorie | Návrh |
Oprava způsobující chybu nebo chybu způsobující chybu | Nenarušující |
Povoleno ve výchozím nastavení v .NET 9 | Jako návrh |
Příčina
Veřejný typ je sealed
(NotInheritable
v jazyce Visual Basic) a deklaruje chráněný člen nebo chráněný vnořený typ. Toto pravidlo neoznamuje porušení metod Finalize , které musí postupovat podle tohoto vzoru.
Popis pravidla
Typy deklarují chráněné členy, aby k nim odvozené typy mohly přistupovat nebo je přepisovat. Podle definice nelze dědit z zapečetěného typu, což znamená, že chráněné metody u zapečetěných typů nelze volat.
Kompilátor C# vygeneruje pro tuto situaci upozornění CS0628 místo CA1047.
Jak opravit porušení
Chcete-li opravit porušení tohoto pravidla, změňte úroveň přístupu člena na soukromý nebo změňte typ zdědit.
Kdy potlačit upozornění
Nepotlačujte upozornění na toto pravidlo. Ponechání typu v aktuálním stavu může způsobit problémy s údržbou a neposkytuje žádné výhody.
Konfigurace kódu pro analýzu
Pomocí následující možnosti nakonfigurujte, ve kterých částech základu kódu se má toto pravidlo spouštět.
Tuto možnost můžete nakonfigurovat jenom pro toto pravidlo, pro všechna pravidla, která platí, nebo pro všechna pravidla v této kategorii (Návrh), na která platí. Další informace naleznete v tématu Možnosti konfigurace pravidla kvality kódu.
Zahrnutí konkrétních povrchů rozhraní API
Na základě přístupnosti můžete nakonfigurovat, na kterých částech základu kódu se má toto pravidlo spouštět. Pokud chcete například určit, že pravidlo by se mělo spouštět jenom na neveřejné ploše rozhraní API, přidejte do souboru .editorconfig v projektu následující pár klíč-hodnota:
dotnet_code_quality.CAXXXX.api_surface = private, internal
Příklad
Následující příklad ukazuje typ, který porušuje toto pravidlo.
public sealed class SealedClass
{
protected void ProtectedMethod(){}
}
Public NotInheritable Class BadSealedType
Protected Sub MyMethod
End Sub
End Class