コードの構文スタイル: オプションのメンバー限定子

C# では、 this キーワードを使用してインスタンスメンバーを修飾し、型名または基本型名を使用して静的メンバーを修飾できます。これらの修飾子は、ローカル変数やメソッドパラメーターによって隠されたメンバーを区別するのに役立ちます。他のすべての場合では、これらの修飾子はオプションであり、使用するかどうかは自分で決めることができます。 ReSharper では、オプションの修飾子の使用に関する環境設定を行い、それらの設定を適用できます。

ReSharper は、既存のコードでオプションのメンバー修飾子を調整し、コード補完やコード生成機能で新しいコードを作成する際や、コードテンプレートの適用、リファクタリングの実行時にも環境設定を考慮します。

オプションのメンバー修飾子にスタイル設定を適用する

デフォルトでは、ReSharper はすべてのオプションのメンバー修飾子を冗長なものとして扱い、削除することを提案します。

オプションの修飾子を使用する場合は、以下で説明するように明示的に指定する必要があります。例: 宣言されている型で静的メソッドを修飾する方が好きかもしれません:

環境設定を変更するとすぐに、ReSharper は同じコードを異なる方法で扱い、対応する修正を提案します：

バルクモードでメンバー修飾子の環境設定を適用する別のオプションは、コードのクリーンアップです。組み込みプロファイルフルクリーンアップまたは再フォーマットして構文スタイルを適用のいずれかを使用してコードクリーンアップを実行するか、後述するように、特定のタスクのみを対象としたカスタムプロファイルを作成して実行することができます。

カスタムコードクリーンアッププロファイルを使用してメンバー修飾子の設定を適用する

メインメニューから ReSharper | オプションを選択するか、 Alt+R O を押します。
クリーンアッププロファイル設定ページに移動します: コード編集 | コードのクリーンアップ | プロファイル。
新しいカスタムクリーンアッププロファイルを作成するセクションの説明に従って、新しいプロファイルを作成します。右側のプロファイル設定で、構文スタイルを適用する | C# ノードを展開し、修飾子を配置するチェックボックスをオンにします。
オプションダイアログで保存をクリックして変更内容を適用し、ReSharper に保存場所を任せるか、保存先セレクターから特定のレイヤーを選択して変更を保存します。詳細については、 resharper 設定の管理と共有をご参照ください。
設定を適用する範囲を選択します。
- ファイル内の任意の場所にキャレットを配置して、ファイルに設定を適用します。
- ソリューションエクスプローラー内の 1 つまたは複数の項目を選択して、これらのノードおよびその子項目にあるファイルに設定を適用します。
次のいずれかを実行します。
- Control+Alt+F を押すか、メインメニューから ReSharper | 編集| コードのクリーンアップ… を選択してください。
- テキストエディターの任意の場所を右クリックするか、選択項目を右クリックし、コンテキストメニューでコードのクリーンアップを選択します。
表示されたコードのクリーンアップダイアログで、新しく作成したプロファイルを選択します。
実行をクリックします。 ReSharper は、選択したスコープで環境設定を適用します。

コードのクリーンアップダイアログを開いてプロファイルを選択することなくメンバー修飾子の環境設定を適用したい場合は、作成したプロファイルをサイレントクリーンアップにバインドし、 Control+Shift+Alt+F を押して実行できます。設定の適用と他のコードスタイルタスクを組み合わせたカスタムクリーンアッププロファイルを作成することもできます。

オプションのメンバー修飾子の環境設定を他のすべてのフォーマットおよび構文スタイルのルールと一緒に選択したコードブロックに適用するには、 Alt+Enter を実行し、再フォーマットとクリーンアップ | 構文スタイルを再フォーマットして適用するを選択します。

変更をファイルに保存するたびにオプションのメンバー修飾子を調整して、編集が常にコードスタイルに準拠するようにすることができます。

変更を保存するときにオプションのメンバー修飾子を自動的に調整する

メインメニューから ReSharper | オプションを選択するか、 Alt+R O を押します。
クリーンアッププロファイル設定ページに移動します: コード編集 | コードのクリーンアップ | プロファイル。
カスタムコードのクリーンアッププロファイルを選択し、デフォルトに設定するをクリックします（デフォルトプロファイルはサイレントクリーンアップにも使用されます）。
コード編集 | コードのクリーンアップ | 一般オプションページに移動し、ファイル保存時にクリーンアップを自動的に実行するを選択します。
オプションで、ファイルマスクによって特定のファイルへの自動クリーンアップを制限できます。
ファイルの変更された部分のみを選択して、変更によって影響を受けるコードにクリーンアップが適用され、ファイル内の残りのコードが変更されないようにすることもできます。
ファイルの変更された部分のみをクリーンアップすることを選択した場合は、次のオプションを使用してこの動作を微調整できます。
- 部分的なクリーンアップが不可能な場合は完全なクリーンアップを実行する — このオプションに応じて、ReSharper はファイル全体をクリーンアップするか、ファイルの変更部分のみのクリーンアップができない場合は対象ファイルをスキップします。
- 共有ファイル保存時のクリーンアップを許可する — このオプションを使用して、共有プロジェクトのファイルなど、ソリューションに複数回含まれるファイルの部分的なクリーンアップを有効または無効にします。
ダイアログで保存をクリックして変更を適用し、ReSharper に保存場所を任せるか、保存先セレクターから特定の設定レイヤーを選択して変更を保存します。詳細については、 resharper 設定の管理と共有をご参照ください。
次回編集を終了してファイル（Ctrl＋S ）またはすべてのファイル（Ctrl＋Shift＋S ）を保存すると、ReSharper は選択したプロファイルで対象ファイルをクリーンアップします。デフォルトのクリーンアッププロファイルが選択されていない場合、ReSharper はプロファイルのいずれかを選択するよう促します。

オプションのメンバー修飾子の設定を構成する

メンバー限定のスタイル設定は、レイヤーベースの設定のメカニズムを使用して保存されます。このメカニズムにより、さまざまなソリューションに対して異なる設定を維持したり、これらの設定をバージョン管理システム (VCS) で管理したり、チームメンバーと自動的に共有したりすることが可能になります。

ReSharper オプションで設定を構成する

ReSharper オプション Alt+R、O のコード編集 | C# | 構文スタイルページに移動します。
インスタンスメンバー資格および静的メンバー資格カテゴリの設定を、コーディングのプラクティス / 標準に従って変更します。
右側の列の通知するセレクターを使って、環境設定と異なるコードを検出する重要度レベルやコードインスペクションを設定できます。
オプションダイアログで保存をクリックして変更内容を適用し、ReSharper に保存場所を任せるか、保存先セレクターから特定のレイヤーを選択して変更を保存します。詳細については、 resharper 設定の管理と共有をご参照ください。

構文スタイルの設定は、すべての言語では EditorConfig 、C++、JavaScript、TypeScript では Clang 形式で行うことができます。これらの設定は、ソリューション階層の異なるレベルにある .editorconfig 、 .clang-format 、 _clang-format ファイルに保存できます。これらのファイルは通常 VCS に配置され、そこで定義された設定がプロジェクトチーム間で共有されます。

ReSharper では、EditorConfig を使って ReSharper のオプションダイアログで設定できる構文スタイルの環境設定を定義できます。サポートされている EditorConfig プロパティの名前と説明は、 EditorConfig リファレンスにあります。

Clang-Format については、ReSharper ではサポートされている Clang-Format オプションのみ適用します。

.editorconfig ファイルで定義された構文スタイルプロパティは、この .editorconfig ファイルが適用されるスコープ内で ReSharper 設定で定義された同じプロパティをオーバーライドする点にご注意ください。 Clang-Format で定義されたフォーマットプロパティは、ReSharper 設定と EditorConfig 設定の両方をオーバーライドします。