ReSharper 2021.1 ヘルプ

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

特定の型のパラメーターに名前付き引数(英語)を使用したい場合は、ReSharper を使用するとこの方法を実行できます。

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

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

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

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

特定の型に対して名前付き引数を使用したい場合は、ReSharper の助けを借りてこの優先順位を適用することができます。

ReSharper は、既存のコードで引数を調整するのに役立ち、コード補完およびコード生成機能を使用して新しいコードを生成し、コードテンプレートを適用し、リファクタリングを実行するときに設定を考慮します。

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

デフォルトでは、ReSharper はどこでも位置引数を使用することを提案しており、名前付き引数を必要とするパラメーターの型を明示的に指定する必要があります。設定に応じて、ReSharper は、名前を必要とする位置引数または位置でなければならない名前付き引数をハイライトし、対応するクイックフィックスまたはスコープ内の修正を提案します

Quick fix that help you add or remove argument names

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

Context action to add or remove argument names

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

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

  1. メインメニューから ReSharper | オプションを選択するか、Alt+R O を押します。

  2. クリーンアッププロファイル設定ページに移動します: コード編集 | コードのクリーンアップ | プロファイル

  3. 新しいカスタムクリーンアッププロファイルを作成するセクションの説明に従って、新しいプロファイルを作成します。新しいプロファイルの選択したプロファイル設定セクションで、引数のスタイルを適用するチェックボックスをオンにします。必要に応じて、このプロファイルで他のコードクリーンアップタスクを有効にすることができます。

  4. オプションダイアログで保存をクリックして変更を適用し、ReSharper に保存場所を選択させるか、次へ保存リストを使用して変更を特定の設定レイヤーに保存します。詳細については、ReSharper 設定の管理と共有を参照してください。

  5. 設定を適用する範囲を選択します。

    • ファイルの任意の場所にキャレットを設定して、ファイルの設定を強制します。

    • ソリューションエクスプローラー内の 1 つまたは複数の項目を選択して、これらのノードおよびその子項目にあるファイルに設定を適用します。

  6. 以下のいずれか 1 つを実行します:

    • Control+Alt+F を押すか、メインメニューから ReSharper | 編集 | コードのクリーンアップ... を選択してください。

    • テキストエディターの任意の場所を右クリックするか、選択項目を右クリックし、コンテキストメニューでコードのクリーンアップを選択します。

  7. 開いているコードのクリーンアップダイアログで、新しく作成したプロファイルを選択します。

  8. 実行をクリックします。ReSharper は、選択した範囲であなたの設定を強制します。

コードのクリーンアップダイアログを開かずに引数を配置してプロファイルを選択する場合は、作成したプロファイルをサイレントクリーンアップにバインドし、Control+Shift+Alt+F を押して実行できます。引数の配置を他のコードスタイルのタスクと組み合わせるカスタムクリーンアッププロファイルを作成することもできます。

名前付き / 位置引数の設定を構成する

引数のスタイル設定は、レイヤーベースの設定のメカニズムを使用して保存されます。とりわけ、このメカニズムにより、さまざまなソリューションのさまざまな設定を維持したり、これらの設定を VCS に保持したり、チームメンバーと自動的に共有することができます。

引数スタイルの設定を構成する

  1. ReSharper オプション(Alt+R, O)のコード編集 | C# | 構文スタイルページに移動します。

  2. 引数カテゴリで、特定のパラメーター型に名前付き引数または位置引数を使用するかどうかを選択します。リテラル値は、文字列を除くすべてのリテラル(boolintdouble など)を指すことに注意してください。文字列の設定は、文字列リテラル値セレクターで定義されます。
    カテゴリその他は、条件付き、null 結合、バイナリ、呼び出し、typeof 式など、他のすべての式型に適用されます

  3. 右側の列の通知するセレクターを使用して、設定とは異なるコードインスペクション検出コードの重大度レベルを設定できます。

  4. オプションダイアログで保存をクリックして変更を適用し、ReSharper に保存場所を選択させるか、次へ保存リストを使用して変更を特定の設定レイヤーに保存します。詳細については、ReSharper 設定の管理と共有を参照してください。

また、エディターで引数を整理するための設定を変更することもできます。ここでは、対応する問題がハイライトされています。

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

  1. ReSharper のインスペクションによってハイライトされたコードの問題にキャレットを設定します。

  2. Alt+Enter を押すか、キャレットの左側にあるアクションインジケーターをクリックして、アクションリストを開きます。

  3. アクションリストで、インスペクション " 優先引数スタイルを使用してください..." | コードスタイルを設定するを選択し、希望のオプションを選択します。

    Changing the preference for named/positional arguments in the editor

  4. 変更は、スマートセーブロジックを使用して保存されます。

  5. 変更されたスタイル設定を共有設定レイヤーに保存する必要がある場合は、コードスタイルを設定するメニュー項目をクリックするか、選択されているときに Enter を押します。ReSharper は、ReSharper オプション(Alt+R, O)のコード編集 | C# | 構文スタイルページを開きます。ここで、必要に応じて設定を変更し、次へ保存をクリックして、目的の設定レイヤーを選択します。

この機能は、次の言語とテクノロジーでサポートされています。

関連ページ:

パラメーター情報 | ReSharper

関数呼び出しを書いたり調べたりしているときはいつでも、ReSharper は関数のすべてのオーバーロードに対して許可された引数に関する詳細を表示できます。ツールチップでは、パラメーターを持つすべてのパブリックシグニチャと、存在する場合は関数のドキュメントから取得した簡単な説明が表示されます。パラメーター情報を使用:パラメーターを入力すると、ReSharper は入力されたパラメーターと互換性のある次の署名を自動的にハイライトし、適用できない署名をグレー表示します。既存の関数呼び出しの代替シグネ...

宣言に移動 | ReSharper

このコマンドを使用して、シンボルの使用方法からシンボルの宣言に移動します。このコマンドは、ソリューションエクスプローラー、ファイル構造ウィンドウ、その他のツールウィンドウから呼び出すことができます。反対方向(シンボルの使用箇所)に移動するには、すでにシンボル宣言にいるときに宣言に移動コマンドを呼び出すか、シンボルの使用箇所にジャンプコマンドを使用できます。インターフェースで宣言されているメソッドやプロパティの使用方法から移動すると、コマンドはインターフェース自体ではなく、使用されている正確な実装...

インレイヒント | ReSharper

インレイヒントは、コードの読みやすさを向上させる構成可能なエディターの装飾です。プッシュツーヒントモード:インレイヒントは役立つ場合がありますが、一方で、エディタースペースを取り、場合によっては冗長に見えることがあります。プッシュツーヒントモード(デフォルトで有効になっている)を使用できます。ヒントを非表示にして、Ctrl キーを押したままにすることで必要な場合にのみヒントを表示できます。このモードでは、Ctrl を 2 回押して、現在のエディタータブのヒントを切り替えることもできます。インレイヒ...

設計時にコードの問題を検出する | ReSharper

ReSharper は、エディターでコードファイルを開くとすぐに分析を開始し、最後まで編集を続けます。検出されたすべてのコードの問題は、重大度に従ってエディターでハイライトされます。問題のマップは、エディターウィンドウの右側のマーカーバーにも表示されます。ここでは、ファイルのステータスを即座に確認し、マークをクリックして特定のコードの問題に移動できます。デザインタイムインスペクションの機能:ReSharper によって実行されるデザインタイムコードインスペクションを説明するために、エディターに...

スコープの修正 | ReSharper

ほとんどのクイックフィックスは、キャレットで現在の問題を修正できますが、中には (たとえば、未使用のディレクティブを削除する、フィールドを読み取り専用にする、冗長なキャストの除去など)、現在のファイル、現在のプロジェクト、またはソリューション全体など、より大きな範囲で問題を自動的に見つけて修正できるものもあります。範囲内の修正を適用する:このような修正は、アクションリストの横に表示される小さな矢印で識別できます。範囲内の修正を適用する ReSharper のインスペクションによってハイライトされ...

コンテキストアクション | ReSharper

コンテキストアクションは、エディターで直接利用できるコード変換ヘルパーです。クイックフィックスとは対照的に、コンテキストアクションは問題の解決やコードの改善を目的としているためはなく、アクセス修飾子の変更、null をチェックするコードの生成、'foreach' の 'for' への変換などの小さな変更を素早く導入できます。ReSharper は、サポートされているすべての言語で数百のコンテキストアクションを提供します。完全なリストは、ReSharper オプションのページとコンテキストアクショ...