CA1047: Deklarera inte skyddade medlemmar i förseglade typer

Property	Värde
Regel-ID	CA1047
Title	Deklarera inte skyddade medlemmar i förseglade typer
Kategori	Designa
Korrigeringen är icke-bakåtkompatibel	Icke-icke-bryta
Aktiverad som standard i .NET 8	Som förslag

Orsak

En offentlig typ är sealed (NotInheritable i Visual Basic) och deklarerar en skyddad medlem eller en skyddad kapslad typ. Den här regeln rapporterar inte överträdelser för Finalize metoder som måste följa det här mönstret.

Regelbeskrivning

Typer deklarerar skyddade medlemmar så att ärvande typer kan komma åt eller åsidosätta medlemmen. Per definition kan du inte ärva från en förseglad typ, vilket innebär att skyddade metoder för förseglade typer inte kan anropas.

C#-kompilatorn genererar varnings-CS0628 i stället för CA1047 för den här situationen.

Så här åtgärdar du överträdelser

Om du vill åtgärda ett brott mot den här regeln ändrar du åtkomstnivån för medlemmen till privat eller gör typen ärverbar.

När du ska ignorera varningar

Ignorera inte en varning från den här regeln. Om du lämnar typen i det aktuella tillståndet kan det orsaka underhållsproblem och ger inga fördelar.

Konfigurera kod för analys

Använd följande alternativ för att konfigurera vilka delar av kodbasen som regeln ska köras på.

• Inkludera specifika API-ytor

Du kan konfigurera det här alternativet för bara den här regeln, för alla regler som gäller för eller för alla regler i den här kategorin (design) som den gäller för. Mer information finns i Konfigurationsalternativ för kodkvalitetsregel.

Inkludera specifika API-ytor

Du kan konfigurera vilka delar av kodbasen som ska köras med den här regeln baserat på deras tillgänglighet. Om du till exempel vill ange att regeln endast ska köras mot den icke-offentliga API-ytan lägger du till följande nyckel/värde-par i en .editorconfig-fil i projektet:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Exempel

I följande exempel visas en typ som bryter mot den här regeln.

public sealed class SealedClass
{
    protected void ProtectedMethod(){}
}

Public NotInheritable Class BadSealedType
    Protected  Sub MyMethod
    End Sub
End Class