CA1047: Nie deklaruj chronionych elementów członkowskich w typach zapieczętowanych
| Właściwości | Wartość |
|---|---|
| Identyfikator reguły | CA1047 |
| Tytuł | Nie deklaruj chronionych składowych w typach zapieczętowanych |
| Kategoria | Projekt |
| Poprawka powodująca niezgodność lub niezgodność | Niezgodność |
| Domyślnie włączone na platformie .NET 9 | Jako sugestia |
Przyczyna
Typ publiczny to sealed (NotInheritable w Visual Basic) i deklaruje chroniony element członkowski lub chroniony typ zagnieżdżony. Ta reguła nie zgłasza naruszeń Finalize metod, które muszą być zgodne z tym wzorcem.
Opis reguły
Chronione elementy członkowskie są zadeklarowane w typach tak, aby typy dziedziczące miały dostęp do elementu członkowskiego i mogły go zastąpić. Z definicji nie można dziedziczyć z typu zapieczętowanego, co oznacza, że nie można wywoływać metod chronionych w typach zapieczętowanych.
Kompilator języka C# emituje ostrzeżenie CS0628 zamiast CA1047 w tej sytuacji.
Jak naprawić naruszenia
Aby naprawić naruszenie tej reguły, zmień poziom dostępu elementu członkowskiego na prywatny lub ustaw typ dziedziczony.
Kiedy pomijać ostrzeżenia
Nie pomijaj ostrzeżeń dla tej reguły. Pozostawienie typu w bieżącym stanie może powodować problemy z konserwacją i nie zapewnia żadnych korzyści.
Konfigurowanie kodu do analizowania
Użyj następującej opcji, aby skonfigurować, które części bazy kodu mają być uruchamiane w tej regule.
Tę opcję można skonfigurować tylko dla tej reguły, dla wszystkich reguł, do których ma ona zastosowanie, lub dla wszystkich reguł w tej kategorii (Projekt), których dotyczy. Aby uzyskać więcej informacji, zobacz Opcje konfiguracji reguły jakości kodu.
Uwzględnij określone powierzchnie interfejsu API
Możesz skonfigurować, na których częściach bazy kodu ma być uruchamiana ta reguła, na podstawie ich ułatwień dostępu. Aby na przykład określić, że reguła powinna być uruchamiana tylko na powierzchni niepublicznego interfejsu API, dodaj następującą parę klucz-wartość do pliku editorconfig w projekcie:
dotnet_code_quality.CAXXXX.api_surface = private, internal
Przykład
W poniższym przykładzie pokazano typ naruszający tę regułę.
public sealed class SealedClass
{
protected void ProtectedMethod(){}
}
Public NotInheritable Class BadSealedType
Protected Sub MyMethod
End Sub
End Class
