コードインスペクション設定を構成する

設計時コードインスペクションを構成する

デフォルトで、ReSharper は、 サポートされている言語に対応するすべてのファイルで 設計時コードインスペクションを有効化します。 必要に応じて、無効にすることができます。 設計時コードインスペクションが有効かどうかに関係なく、コードインスペクションは常に 特定のスコープで実行できます。

コードインスペクションからファイルとフォルダーを除外する

ReSharper では、コードインスペクションから除外すべきファイル、ファイルマスク、フォルダーのリストを構成できます。 除外された項目は、 設計時コードインスペクションや 特定スコープでのコードインスペクションの両方で無視されますが、ReSharper によってインデックスが作成されるので、コードインスペクションから除外されたシンボルにも 移動したり リファクタリングしたりできます。

現在のファイルをコードインスペクションからすぐに除外し、ReSharper がこのファイルを除外ファイル一覧にオプションを開かずに追加できるようにすることもできます。

コードインスペクションが無効化されているファイルは、 ステータスインジケーター上の一時停止アイコン で判別できます。

凍結されたプロジェクトをインデックスから除外する

ReSharper オプション Alt+R、O の コードインスペクション | 無視されたコード ページで、 無視するプロジェクト リストを使うと、ReSharper が完全に無視するプロジェクトを指定することもできます。

無視されたプロジェクトは ReSharper によってインデックスが作成されず、そのプロジェクトでは、たとえば コード解析、 リファクタリング、 コード生成 などの ReSharper の機能を利用できません。

このリストは主に、サードパーティコードや凍結されたコードを含み、変更されることのないプロジェクトのインデックス作成や解析を行わないことで、 パフォーマンスを向上させるために使用します。

無視されたプロジェクトのソースファイルは解析されませんが、ReSharper はそれらのプロジェクトの出力からコンパイル済みのコードを処理します（これはパフォーマンスの面で非常に負荷が小さいです）。 これは、無視されたプロジェクトをビルドした後、ReSharper がそれらのプロジェクトからのシンボルの使用を正しく解決し、そのプロジェクトで 移動および検索 を活用できることを意味します。

無視リストへプロジェクトを追加した後に「シンボルを解決できません」のようなエラーが発生した場合は、無視されたプロジェクトをビルドする必要があり、ReSharper がコンパイル済みアーティファクトからそれらのシンボルを解決できるようになります。

プロジェクトを無視リストに追加するには、プロジェクトファイル名（ ProjectOne.csproj など）またはファイルマスク（ Project*.csproj など）を使用して、 ProjectOne.csproj 、 ProjectTwo.csproj などと一致させます。

生成されたコードのコードインスペクションを部分的に無効にする

生成されたコードを含むファイル、フォルダー、ファイルマスク、領域のリストを構成することもできます。 これらの項目に対して、ReSharper はコンパイラーエラーや警告をチェックする コードインスペクションのみを実行します。 *.designer.cs など、生成されたコードに通常使用されるいくつかのファイルマスクと領域は、デフォルトでこのリストに含まれていますが、必要に応じてデフォルト設定を変更できます。

ソリューションで .editorconfig を使用する場合は、 generated_code プロパティを使用して生成されたコードにマークを付けることもできます。 たとえば、次のようになります。

生成されたコードを含むアイテムのリストは、生成されたコードの コードクリーンアップを無効にするためにも使用できます。

コードインスペクションの重大度レベルを変更する

各 ReSharper のコードインスペクションには固有のデフォルト 重要度レベルがあり、検出したコード問題の潜在的な影響に基づいて設定されています。 ほとんどのインスペクションは、設定可能な重大度レベルを持ち、変更できます。

インスペクションの重大度レベルは、このインスペクションによって検出されたコードの問題がハイライトされるエディターから直接変更できます。

変更した重要度レベルを共有設定レイヤーに保存したり、複数のインスペクションの重要度レベルを変更したりする別の方法は、下記の ReSharper オプション ダイアログ Alt+R、O を使うことです。

特定のコードインスペクションを無効 / 有効にする

一部のコードインスペクションが些細なものであるか、興味がないように思われる場合は、このインスペクションを無効にして、 特定のスコープでコードインスペクション を実行したときに、関連する問題がエディターでハイライトされたり検出されたりしないようにすることができます。 無効化されたコードインスペクションは、後でいつでも有効にできます。 一部のインスペクションはデフォルトで無効になっており、必要に応じて有効にできます。

次のいずれかの方法でコードインスペクションを無効にすることができます。

• エディターでこのインスペクションによってハイライトされたコードの問題がある場合は、ハイライトされたコードにキャレットを置き、 Alt+Enter を押して、 インスペクション [name of inspection] | インスペクションの重大度を設定する | 表示しない を選択します。

• コードインスペクション | インスペクション重大度 ページ（ReSharper オプション Alt+R、O ）で、検索フィールドを使って無効化または有効化したいインスペクションを探し、その横にあるチェックボックスを使用します。

インスペクションの無効 / 有効状態は、 重大度レベルの変更とまったく同じ方法で 共有設定レイヤーに保存されます。

EditorConfig を使用して、コードインスペクションを構成する

プロジェクトのコードスタイルを管理する ために EditorConfig を使用する場合は、 .editorconfig ファイルからコードインスペクションを設定することもできます。

EditorConfig からコードインスペクションを設定するには、ReSharper オプション Alt+R、O の コードインスペクション | 設定 ページで editorconfig とプロジェクト設定から設定を読み込む チェックボックスを選択する必要があります。

EditorConfig の規則に従い、ReSharper は現在のファイルのディレクトリおよびすべての親ディレクトリにある .editorconfig という名前のファイルに定義されたインスペクション設定を、ルートファイルパスに到達するか root=true を含む EditorConfig ファイルが見つかるまで適用します。 .editorconfig ファイルで指定されているファイルマスク、たとえば *Test.cs も考慮されます。

.editorconfig ファイルのインスペクション設定は他のプロパティと同様に、対応する行を追加することで構成します：

例: 次の行を使用して、 可能性のある 'System.NullReferenceException' インスペクションの 重大度レベルを エラーに変更できます。

または、次の行で デフォルト値による冗長引数インスペクションを無効にすることができます。

各インスペクションの EditorConfig プロパティは、 コードインスペクションインデックス セクションと EditorConfig プロパティのインデックス ページのページにあります。 - ブラウザー検索を使用して目的のインスペクションのプロパティを探すだけです。

特定のスコープ内のコードインスペクションを抑制する

特定のコードの問題を無視する 1 つの方法は、 対応するコードインスペクションを無効にすることです。 この場合、このインスペクションによって検出されたすべてのコードの問題はどこでも無視されます。

特定の場所で特定のインスペクションを抑制し、他の場所でこのインスペクションに関する他の同様の問題を引き続き検出する必要がある場合があります。

例えば、ReSharper は一部のコードを「デッド」と見なし、それが正しいことがわかります。 インスペクションは便利であり、無効にしたくありません。 ただし、後でこのコードを使用して、 エディター でハイライトしたり、インスペクションの結果に表示したりしたくない場合があります。 そのために、ReSharper ではコメントや属性でインスペクションを抑制できます。 コメントは任意のコードに対してより便利であり、メソッドまたはタイプ全体でインスペクションを抑制するには属性が望ましいです。

型やメソッド内のすべてのインスペクションを抑制するには、次の属性を追加します： [SuppressMessage("ReSharper", "All")]。