言語と不要なルール

  • [アーティクル]

コードスタイルの言語規則は、.NET プログラミング言語のさまざまなコンストラクト (修飾子、かっこなど) の使用方法に影響します。

このカテゴリには、不要なコード規則は、不要でリファクタリングまたは削除することができるコード ベースのさまざまな部分を特定します。 不要なコードが存在する場合は、次の問題の 1 つ以上が存在することを示しています。

  • 読みやすさ: 読みやすさを不必要に低下させるコード。
  • 保守容易性: リファクタリング後に使用されなくなり、不必要に維持されるコード。
  • パフォーマンス: 副作用がなく、不要なパフォーマンスのオーバーヘッドが発生する不要な計算。
  • 機能: コードの冗長なレンダリングが必要となるコードの機能の問題。 たとえば、IDE0060 は、メソッドで誤って入力パラメーターを無視した場合に、未使用のパラメーターにフラグを設定します。

この規則は次のカテゴリに分けられます:

  • .NET スタイル規則: C# と Visual Basic の両方に適用される規則。 これらの規則のオプション名は dotnet_style_ のプレフィックスで始まります。
  • C# スタイル規則: C# コードに固有の規則。 これらの規則のオプション名は csharp_style_ のプレフィックスで始まります。
  • Visual Basic のスタイル規則: Visual Basic のコードに固有の規則。 これらの規則のオプション名は visual_basic_style_ のプレフィックスで始まります。

オプションの書式

言語ルールの多くには、優先スタイルをカスタマイズするためのオプションが 1 つ以上関連付けられています。 たとえば、Use simple 'using' ステートメント (IDE0063) には、using 宣言とusing ステートメントのどちらを使用するかを定義できるオプションcsharp_prefer_simple_using_statementが関連付けられています。 この規則では、指定したレベルで選択したオプション (警告やエラーなど) が適用されます。

言語規則のオプションは、構成ファイルに、次の形式で指定できます。

option_name = value (Visual Studio 2019 以降)

or

option_name = value:severity

  • Value

    各言語規則では、そのスタイルを優先する場合や状況を指定します。 多くのルールでは、true (このスタイルを優先する) または false (このスタイルを優先しない) の値が受け付けられます。 それ以外では、when_on_single_line や never などの値が受け付けられます。

  • Severity (Visual Studio 2019 バージョン以降のバージョンでは省略可能)

    規則の 2 番目の部分では、規則の重大度レベルを指定します。 .NET 9 以降のバージョンでは、重大度は常に尊重されます。つまり、開発 IDE 内や コマンド ライン ビルド中です。 .NET 8 以前のバージョンでは、この重大度設定は、ビルド中ではなく、Visual Studio などの開発 IDE 内でのみ考慮されます。

    .NET 8 SDK 以前のバージョンを使用していて、ビルド時に重大度を尊重する場合は、次の 2 つの方法のいずれかでこれを行うことができます。

ヒント

Visual Studio 2019 以降、スタイル違反後、[クイック アクション] という電球メニューからコード スタイルの規則を構成できます。

ルール インデックス

言語と不要なコード 規則は、式レベルの基本設定、コード ブロックの基本設定、修飾子の基本設定などのサブカテゴリに分類されます。

usingusing ディレクティブの基本設定

.NET スタイル規則 (C# と Visual Basic):

C# スタイル規則:

コード ブロックの基本設定

C# スタイル規則:

式形式のメンバー

C# スタイル規則:

式レベルの基本設定

.NET スタイル規則 (C# と Visual Basic):

C# スタイル規則:

Visual Basic のスタイル規則:

フィールド設定

.NET スタイル規則 (C# と Visual Basic):

言語キーワード とフレームワークの種類の基本設定

.NET スタイル規則 (C# と Visual Basic):

修飾子の基本設定

.NET スタイル規則 (C# と Visual Basic):

C# スタイル規則:

新しい行の基本設定

  • 複数の空白行を許可する (IDE2000)
  • 同じ行で埋め込みステートメントを許可する (IDE2001)
  • 連続する中かっこの間に空白行を許可する (IDE2002)
  • ブロックの直後の Allow ステートメント (IDE2003)
  • コンストラクター初期化子でコロンの後に空白行を許可する (IDE2004)
  • 条件式でトークンの後に空白行を許可する (IDE2005)
  • 矢印式でトークンの後に空白行を許可する (IDE2006)

"Null" 検査設定

C# スタイル規則:

パラメーターのユーザー設定

.NET スタイル規則 (C# と Visual Basic):

かっこの基本設定

.NET スタイル規則 (C# と Visual Basic):

パターン マッチングの基本設定

C# スタイル規則:

抑制の基本設定

.NET スタイル規則 (C# と Visual Basic):

This. および me. 設定

.NET スタイル規則 (C# と Visual Basic):

var 基本設定

C# スタイル規則:

関連項目