CA1047: Geschützte Member in versiegelten Typen nicht deklarieren.

Eigenschaft	Wert
Regel-ID	CA1047
Titel	Deklarieren Sie keine geschützten Member in versiegelten Typen.
Kategorie	Design
Fix führt zu Unterbrechungen oder bleibt funktionsfähig	Untrennbar
Standardmäßig in .NET 10 aktiviert	Als Vorschlag
Anwendbare Sprachen	C# und Visual Basic

Ursache

Ein öffentlicher Typ ist sealed (NotInheritable in Visual Basic) und deklariert ein geschütztes Mitglied oder einen geschützten geschachtelten Typ. Diese Regel meldet keine Verstöße bei Finalize-Methoden, die diesem Muster folgen müssen.

Regelbeschreibung

Typen deklarieren geschützte Mitglieder, damit erbende Typen auf das Mitglied zugreifen oder es überschreiben können. Per Definition kann von versiegelten Typen nicht geerbt werden. Das bedeutet, dass geschützte Methoden für versiegelte Typen nicht aufgerufen werden können.

Der C#-Compiler gibt die Warnung CS0628 anstelle von CA1047 für diese Situation aus.

So beheben Sie Verstöße

Um einen Verstoß gegen diese Regel zu beheben, ändern Sie die Zugriffsebene des Mitglieds auf privat oder ändern Sie den Typ auf vererbbar.

Wann sollten Warnungen unterdrückt werden?

Unterdrücken Sie keine Warnung dieser Regel. Das Belassen des Typs in seinem aktuellen Zustand kann zu Wartungsproblemen führen und bietet keine Vorteile.

Konfigurieren des zu analysierenden Codes

Mithilfe der folgenden Option können Sie konfigurieren, für welche Teile Ihrer Codebasis diese Regel ausgeführt werden soll.

• Einschließen bestimmter API-Oberflächen

Sie können diese Optionen nur für diese Regel, für alle zutreffenden Regeln oder für alle zutreffenden Regeln in dieser Kategorie (Entwurf) konfigurieren. Weitere Informationen finden Sie unter Konfigurationsoptionen für die Codequalitätsregel.

Einschließen bestimmter API-Oberflächen

Sie können konfigurieren, auf welchen Teilen Ihrer Codebasis je nach Barrierefreiheit diese Regel ausgeführt werden soll, indem Sie die Option api_surface festlegen. Sie können beispielsweise festlegen, dass die Regel nur für die nicht öffentliche API-Oberfläche ausgeführt werden soll, indem Sie einer EDITORCONFIG-Datei in Ihrem Projekt das folgende Schlüssel-Wert-Paar hinzufügen:

dotnet_code_quality.CAXXXX.api_surface = private, internal

Hinweis

Ersetzen Sie den XXXX-Teil von CAXXXX durch die ID der anwendbaren Regel.

Beispiel

Das folgende Beispiel zeigt einen Typ, der gegen diese Regel verstößt.

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

Public NotInheritable Class BadSealedType
    Protected  Sub MyMethod
    End Sub
End Class