次の方法で共有

言語と不要なルール

コードスタイルの言語規則は、.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) には、csharp_prefer_simple_using_statement 宣言とusing ステートメントのどちらを使用するかを定義できるオプションusingが関連付けられています。 この規則では、指定したレベルで選択したオプション (警告やエラーなど) が適用されます。

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

option_name = value (Visual Studio 2019 以降)

または

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 つの方法のいずれかでこれを行うことができます。

    • <AnalysisLevel>プロパティまたは <AnalysisLevelStyle> プロパティを 9.0 以上に設定するか、previewに設定します。
    • 代わりに、アナライザーのルール ID ベースの重大度構成構文を使用して重大度を設定します。 この構文では dotnet_diagnostic.<rule ID>.severity = <severity> 形式が使用されます。たとえば、dotnet_diagnostic.IDE0040.severity = warning のようになります。 詳細については、「重大度レベル」を参照してください。

ヒント

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

ルール インデックス

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

usingディレクティブの設定

.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# スタイル規則:

新しい行の設定の好み

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

C# スタイル規則:

†これらの規則は試験的であり、変更または削除される可能性があります。

ヌルチェック設定

C# スタイル規則:

パラメーター設定

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

かっこの基本設定

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

パターン マッチングの設定オプション

C# スタイル規則:

抑制設定

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

C# スタイル規則:

This. および me. プリファレンス

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

var 基本設定

C# スタイル規則:

関連項目

  • Last updated on