CA1012: Abstrakte Typen dürfen keine öffentlichen Konstruktoren enthalten

Artikel
09/07/2023

Eigenschaft	Wert
Regel-ID	CA1012
Titel	Abstrakte Typen dürfen keine öffentlichen Konstruktoren enthalten
Kategorie	Design
Fix führt oder führt nicht zur Unterbrechung	Nicht unterbrechend
Standardmäßig in .NET 9 aktiviert	No

Ursache

Ein Typ ist abstrakt und verfügt über einen öffentlichen Konstruktor.

Standardmäßig werden mit dieser Regel nur extern sichtbare Typen überprüft, aber dies ist konfigurierbar.

Regelbeschreibung

Konstruktoren von abstrakten Datentypen können nur von abgeleiteten Typen aufgerufen werden. Da öffentliche Konstruktoren Instanzen eines Typs erstellen und Sie keine Instanzen eines abstrakten Datentyps erstellen können, ist ein abstrakter Datentyp mit einem öffentlichen Konstruktor fehlerhaft konzipiert.

Behandeln von Verstößen

Um einen Verstoß gegen diese Regel zu beheben, kennzeichnen Sie entweder den Konstruktor als geschützt, oder deklarieren Sie den Typ nicht als abstrakt.

Wann sollten Warnungen unterdrückt werden?

Unterdrücken Sie keine Warnung dieser Regel. Der abstrakte Typ hat einen öffentlichen Konstruktor.

Unterdrücken einer Warnung

Um nur eine einzelne Verletzung zu unterdrücken, fügen Sie der Quelldatei Präprozessoranweisungen hinzu, um die Regel zu deaktivieren und dann wieder zu aktivieren.

#pragma warning disable CA1012
// The code that's violating the rule is on this line.
#pragma warning restore CA1012

Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad in der Konfigurationsdatei auf none fest.

[*.{cs,vb}]
dotnet_diagnostic.CA1012.severity = none

Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.

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

Der folgende Codeausschnitt enthält einen abstrakten Typ, der gegen diese Regel verstößt.

' Violates this rule      
Public MustInherit Class Book

    Public Sub New()
    End Sub

End Class

// Violates this rule
public abstract class Book
{
    public Book()
    {
    }
}

Mit dem folgenden Codeausschnitt wird die vorherige Verletzung korrigiert, indem der Zugriff auf den Konstruktor von public in protected geändert wird.

// Does not violate this rule
public abstract class Book
{
    protected Book()
    {
    }
}

' Violates this rule      
Public MustInherit Class Book

    Protected Sub New()
    End Sub

End Class

Freigeben über