コードの構文スタイル: 名前付き / 位置引数

特定の種類のパラメーターに名前付き引数を使いたい場合は、ReSharper でこの方法を徹底できます。

次のメソッド呼び出しを考えてみましょう。

AddCheckbox(true, true, "AutoFill", null);

このコードを読むときは、ここで何が起こるかを理解するために、メソッドシグネチャーを停止して調査する必要があります（パラメーター情報ツールチップを使用するか、メソッド宣言に移動することで実行できます）。名前付き引数を使用すると、同じ呼び出しがより明確になります。

AddCheckbox(enabled: true, value: true, label: "AutoFill", tooltip: null);

特定の型に名前付き引数を使いたい場合は、ReSharper でこの環境設定を強制できます。

ReSharper は既存のコード内の引数の整理を支援し、コード補完やコード生成機能で新しいコードを作成する際、コードテンプレートの適用やリファクタリングの実行時に環境設定を考慮します。

引数にスタイル設定を適用する

デフォルトでは、ReSharper はすべての場所で位置引数の使用を推奨しており、どのパラメーター型に名前付き引数が必要かを明示的に指定する必要があります。環境設定に基づき、ReSharper は名前が必要な位置引数や位置引数にすべき名前付き引数をハイライトし、対応するクイックフィックスやスコープ内修正を提案します：

引数の環境設定がない場合でも、名前付きまたは位置引数上で Alt+Enter を押すと、対応するコンテキストアクションで引数名の追加や削除が可能です：

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

カスタムコードクリーンアッププロファイルで引数スタイルを適用する

メインメニューから ReSharper | オプションを選択するか、 Alt+R O を押します。
クリーンアッププロファイル設定ページに移動します: コード編集 | コードのクリーンアップ | プロファイル。
新しいカスタムクリーンアッププロファイルを作成するセクションの説明に従って、新しいプロファイルを作成します。右側のプロファイル設定で、構文スタイルを適用する | C# ノードを展開し、引数スタイルを適用する（名前付き vs. 位置）チェックボックスをオンにします。
オプションダイアログで保存をクリックして変更内容を適用し、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 オプション Alt+R、O のコード編集 | C# | 構文スタイルページに移動します。
引数カテゴリで、特定のパラメーター型に名前付き引数と位置引数のどちらを使用するかを選択します。リテラル値は、文字列を除くすべてのリテラル（bool、 int、 double など）を参照することに注意してください。文字列の設定は、文字列リテラル値セレクターで定義されます。
カテゴリその他は、条件式、NULL 合体式、バイナリ式、呼び出し式、 typeof 式など、他のすべての式タイプに適用されます。
右側の列の通知するセレクターを使って、環境設定と異なるコードを検出する重要度レベルやコードインスペクションを設定できます。
オプションダイアログで保存をクリックして変更内容を適用し、ReSharper に保存場所を任せるか、保存先セレクターから特定のレイヤーを選択して変更を保存します。詳細については、 resharper 設定の管理と共有をご参照ください。

エディター上で、対応する問題がハイライトされている場合、引数の調整に関する環境設定を変更できます。

エディターで名前付き / 位置引数の設定を変更

ReSharper のインスペクションでハイライトされたコードの問題にキャレットを合わせます。
Alt+Enter を押すか、キャレットの左側にあるアクションインジケーターをクリックしてアクションリストを開きます。
アクションリストで、インスペクション " 優先引数スタイルを使用してください ..." | コードスタイルを設定するを選択し、希望のオプションを選択します。
変更は、スマートセーブロジックを使用して保存されます。
変更したスタイル環境設定を共有設定レイヤーに保存する場合は、コードスタイルを設定するメニュー項目をクリックするか、選択した状態で Enter を押してください。 ReSharper は ReSharper オプションのコード編集 | C# | 構文スタイルページを開くので、必要に応じて環境設定を修正し、保存先をクリックして希望の設定レイヤーを選択します。

構文スタイルの設定は、すべての言語では 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 設定の両方をオーバーライドします。