CA1012: 抽象型にはパブリックコンストラクターを含めない

原因

抽象型で、パブリックコンストラクターがあります。

既定では、この規則の対象は外部から参照できる型のみですが、これは構成可能です。

抽象型上のコンストラクターは、派生型からのみ呼び出すことができます。パブリックコンストラクターで型のインスタンスが作成され、抽象型のインスタンスは自分で作成できないため、パブリックコンストラクターが含まれる抽象型のデザインは不適切になります。

この規則違反を修正するには、コンストラクターを保護するか、型を抽象として宣言しないようにします。

この規則による警告は抑制しないでください。抽象型にはパブリックコンストラクターがあります。

単一の違反を抑制するだけの場合は、ソースファイルにプリプロセッサディレクティブを追加して無効にしてから、規則をもう一度有効にします。

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

ファイル、フォルダー、またはプロジェクトの規則を無効にするには、構成ファイルでその重要度を none に設定します。

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

詳細については、「コード分析の警告を抑制する方法」を参照してください。

次のオプションを使用して、コードベースのどの部分に対してこの規則を実行するか構成します。

このオプションを構成できる対象は、この規則だけ、それを適用するすべての規則、それを適用するこのカテゴリ (デザイン) のすべての規則のいずれかです。詳細については、「コード品質規則の構成オプション」を参照してください。

ユーザー補助に基づいて、この規則を実行するコードベースの部分を構成できます。たとえば、非パブリック API サーフェイスでのみ規則を実行するように指定するには、プロジェクトの .editorconfig ファイルに次のキーと値のペアを追加します。

dotnet_code_quality.CAXXXX.api_surface = private, internal

次のコードスニペットには、この規則に違反する抽象型が含まれています。

' Violates this rule      
Public MustInherit Class Book

    Public Sub New()
    End Sub

End Class

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

次のコードスニペットは、コンストラクターのアクセシビリティを public から protected に変更することによって、上記の違反を修正します。

// 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