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

Artikel
04/18/2024

Eigenschaft	Wert
Regel-ID	CA1047
Titel	Geschützte Member in versiegelten Typen nicht deklarieren.
Kategorie	Design
Fix führt oder führt nicht zur Unterbrechung	Nicht unterbrechend
Standardmäßig in .NET 9 aktiviert	Als Vorschlag

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 Member, damit erbende Typen auf den Member zugreifen oder diesen ü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.

Behandeln von Verstößen

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 je nach Zugänglichkeit festlegen, für welche Bestandteile Ihrer Codebasis diese Regel ausgeführt wird. 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

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

Freigeben über