CA1052: スタティック ホルダー型は Static または NotInheritable でなければなりません
| プロパティ | 値 |
|---|---|
| ルール ID | CA1052 |
| Title | スタティック ホルダー型は Static または NotInheritable でなければなりません |
| [カテゴリ] | デザイン |
| 修正が中断ありか中断なしか | あり |
| .NET 8 では既定で有効 | いいえ |
原因
非抽象型に静的メンバー (可能な既定のコンストラクター以外) のみが含まれ、static または Shared 修飾子を使用して宣言されていません。
既定では、この規則の対象は外部から参照可能な型のみですが、これは構成可能です。
規則の説明
規則 CA1052 は、静的メンバーのみを含む型は継承されるように設計されていないことを前提としています。これは、派生型でオーバーライドできる機能がその型に用意されていないためです。 継承されることを意図していない型は、基本データ型としての使用を禁止するために、C# では static 修飾子を使用してマークする必要があります。 さらに、その既定のコンストラクターを削除する必要があります。 Visual Basic では、そのクラスをモジュールに変換する必要があります。
この規則は、抽象クラスや基底クラスを持つクラスには適用されません。 ただし、空のインターフェイスをサポートするクラスに対しては、この規則が適用されます。
注意
この規則の最新のアナライザーの実装では、規則 CA1053 の機能も含まれています。
違反の修正方法
この規則の違反を修正するには、型を static としてマークし、既定のコンストラクターを削除するか (C#)、モジュールに変換します (Visual Basic)。
どのようなときに警告を抑制するか
次の場合は違反を表示しないようにすることができます。
- 型が継承されるように設計されています。
static修飾子がないことは、その型が基本データ型として有用であることを示しています。 - 型が型引数として使用されています。 スタティック型を型引数として使用することはできません。
警告を抑制する
単一の違反を抑制するだけの場合は、ソース ファイルにプリプロセッサ ディレクティブを追加して無効にしてから、規則をもう一度有効にします。
#pragma warning disable CA1052
// The code that's violating the rule is on this line.
#pragma warning restore CA1052
ファイル、フォルダー、またはプロジェクトの規則を無効にするには、構成ファイルでその重要度を none に設定します。
[*.{cs,vb}]
dotnet_diagnostic.CA1052.severity = none
詳細については、「コード分析の警告を抑制する方法」を参照してください。
分析するコードを構成する
次のオプションを使用して、コードベースのどの部分に対してこの規則を実行するか構成します。
このオプションを構成できる対象は、この規則だけ、それを適用するすべての規則、それを適用するこのカテゴリ (デザイン) のすべての規則のいずれかです。 詳細については、「コード品質規則の構成オプション」を参照してください。
特定の API サーフェイスを含める
ユーザー補助に基づいて、この規則を実行するコードベースの部分を構成できます。 たとえば、非パブリック API サーフェイスでのみ規則を実行するように指定するには、プロジェクトの .editorconfig ファイルに次のキーと値のペアを追加します。
dotnet_code_quality.CAXXXX.api_surface = private, internal
違反の例
次の例は、規則に違反する型を示しています。
public class StaticMembers
{
public static int SomeProperty { get; set; }
public static void SomeMethod() { }
}
Imports System
Namespace ca1052
Public Class StaticMembers
Shared Property SomeProperty As Integer
Private Sub New()
End Sub
Shared Sub SomeMethod()
End Sub
End Class
End Namespace
static 修飾子を使用して修正する
次の例は、C# で static 修飾子を使用して型をマークすることで、この規則違反を修正する方法を示しています。
public static class StaticMembers
{
public static int SomeProperty { get; set; }
public static void SomeMethod() { }
}
.NET