| 財産 | 価値 |
|---|---|
| ルール ID | IDE0290 |
| タイトル | プライマリ コンストラクターを使用する |
| カテゴリ | スタイル |
| サブカテゴリ | 言語ルール (コード ブロックの基本設定) |
| 該当する言語一覧 | C# バージョン 12 以降 |
| オプション | csharp_style_prefer_primary_constructors |
概要
この規則は、別のコンストラクター定義ではなく、プライマリ コンストラクター を使用できるクラスにフラグを設定します。 プライマリ コンストラクターを定義するには、型名の後に任意のコンストラクター パラメーターをかっこで囲みます。 プライマリ コンストラクターは、これらのパラメーターが型の任意のインスタンスに必要であることを示します。
複数のコンストラクターを持つクラスまたは構造体を作成すると、柔軟性が向上しますが、詳細構文も追加します。 コンストラクターの入力をクラスの状態からクリーンに分離する必要があります。 プライマリ コンストラクターでは、クラス全体または構造体のスコープに 1 つのコンストラクターのパラメーターを配置できます。 これらのパラメーターは、初期化に使用することも、オブジェクトの状態として直接使用することもできます。 ただし、他のコンストラクターを追加する場合は、プライマリ コンストラクターを介して呼び出す必要があります。
オプション
オプションでは、ルールを適用する動作を指定します。 オプションの構成については、「オプション形式 を参照してください。
csharp_style_prefer_primary_constructors
| 財産 | 価値 | 説明 |
|---|---|---|
| オプション名 | csharp_style_prefer_primary_constructors | |
| オプション値 | true |
プライマリ コンストラクターを使用します。 |
false |
ルールを無効にします。 | |
| 既定のオプション値 | true |
例
// Code with violations.
class C
{
public C(int i) { }
}
// Fixed code.
class C(int i)
{
}
警告を抑制する
1 つの違反のみを抑制する場合は、ソース ファイルにプリプロセッサ ディレクティブを追加して無効にしてから、ルールを再度有効にします。
#pragma warning disable IDE0290
// The code that's violating the rule is on this line.
#pragma warning restore IDE0290
ファイル、フォルダー、またはプロジェクトのルールを無効にするには、その重大度を noneに に設定します。
[*.{cs,vb}]
dotnet_diagnostic.IDE0290.severity = none
すべてのコード スタイルルールを無効にするには、カテゴリ Style の重大度を、noneに するように設定します。
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
詳細については、「コード分析の警告を抑制する方法」を参照してください。
.NET