CA1000:ジェネリック型の静的メンバーを宣言しません

  • [アーティクル]
プロパティ 値
ルール ID CA1000
Title ジェネリック型の静的メンバーを宣言しません
[カテゴリ] デザイン
修正が中断ありか中断なしか あり
.NET 8 では既定で有効 いいえ

原因

ジェネリック型に、static (Visual Basic では Shared) メンバーが含まれています。

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

規則の説明

ジェネリック型の static メンバーを呼び出すときには、その型の型引数も指定する必要があります。 推論をサポートしないジェネリック インスタンス メンバーを呼び出すときには、そのメンバーに型引数を指定する必要があります。 次の呼び出しで示すように、型引数を指定するための構文は、この 2 つのケースで異なっており、混同しやすくなっています。

' Shared method in a generic type.
GenericType(Of Integer).SharedMethod()

' Generic instance method that does not support inference.
someObject.GenericMethod(Of Integer)()

// Static method in a generic type.
GenericType<int>.StaticMethod();

// Generic instance method that does not support inference.
someObject.GenericMethod<int>();

一般に、メンバーを呼び出すときに型引数を指定する必要がないように、前の宣言はどちらも回避する必要があります。 これにより、ジェネリックでメンバーを呼び出すための構文は、非ジェネリックの構文と同じになります。

違反の修正方法

この規則違反を修正するには、静的メンバーを削除するか、またはインスタンス メンバーに変更します。

どのようなときに警告を抑制するか

この規則による警告は抑制しないでください。 わかりやすく使いやすい構文でジェネリックスを提供すると、学習に必要な時間が短縮され、新しいライブラリの採用率が高まります。

警告を抑制する

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

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

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

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

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

分析するコードを構成する

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

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

特定の API サーフェイスを含める

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

dotnet_code_quality.CAXXXX.api_surface = private, internal

関連項目