ReSharper 2020.2ヘルプ

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

特定のタイプのパラメーターに名前付き引数(英語)を使用したい場合は、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つのオプションは、コードのクリーンアップです。デフォルトのプロファイルフルクリーンアップまたは再フォーマットして構文スタイルを適用のいずれかを使用してコードのクリーンアップを実行するか、または以下に説明されているように特定のタスク専用のカスタムプロファイルを作成して実行することができます。

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

  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. 引数カテゴリで、特定のパラメータタイプに名前付き引数または位置引数を使用するかどうかを選択します。リテラル値は、文字列を除くすべてのリテラル(bool , int , doubleなど)を指すことに注意してください。文字列の設定は、文字列リテラル値セレクターで定義されます。
    カテゴリその他は、条件付き、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# | 構文スタイルページを開きます。ここで、必要に応じて設定を変更し、次へ保存をクリックして、目的の設定レイヤーを選択します。

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

Language: C#Language: VB.NETLanguage: C++Language: HTMLLanguage: ASP.NETLanguage: RazorLanguage: JavaScriptLanguage: TypeScriptLanguage: CSSLanguage: XMLLanguage: XAMLLanguage: ResxLanguage: Build ScriptsLanguage: ProtobufLanguage: JSON
Feature is available in C#Feature is not available in Visual Basic .NETFeature is not available in C++Feature is not available in HTMLFeature is not available in ASP.NETFeature is not available in RazorFeature is not available in JavaScriptFeature is not available in TypeScriptFeature is not available in CSSFeature is not available in XMLFeature is not available in XAMLFeature is not available in Resource filesFeature is not available in build script filesFeature is not available in ProtobufFeature is not available in JSON
最終更新日:

関連ページ:

パラメータ情報

ReSharper | 編集 | パラメータ情報関数呼び出しを書いたり調べたりしているときはいつでも、ReSharperは関数のすべてのオーバーロードに対して許可された引数に関する詳細を表示できます。ツールチップでは、パラメータを持つすべてのパブリックシグニチャと、存在する場合は関数のドキュメントか...

宣言に移動

ReSharper | ナビゲート | 宣言に移動このコマンドを使用して、シンボルの使用方法からシンボルの宣言に移動します。このコマンドは、ソリューションエクスプローラー、ファイル構造ウィンドウ、およびその他のツールウィンドウから呼び出すことができます。反対方向(シンボルの使用箇所)に移動するには、...

コード補完 (IntelliSense)

ReSharperは、高度な機能を備えたVisual Studioのネイティブコード補完(IntelliSense)を補完し、拡張します。例:あなたの入力に基づいて提案のリストを絞り込み、選択したタイプと拡張メソッドを自動的にインポートし、メソッド名を補完するときに括弧を追加し、タイプに応じて変数と...

コード生成

ReSharperは、定型コードを生成するさまざまな方法を提供します。例:宣言されていないコードシンボルを使用し、これらのシンボルを用途に基づいて自動的に生成したり、型メンバーを生成したりすることができます。現在のファイルで設計時コードインスペクションが有効になっている場合、ReSharperは足り...

インレイ・ヒント

インレイヒントは、コードの読みやすさを向上させる構成可能なエディターの装飾です。パラメーター名ヒント:メソッド呼び出しで名前付き引数を書き込む代わりに、ReSharperのパラメーター名ヒント(メソッド呼び出しで対応する引数の横にパラメーター名を表示するエディターの装飾)を利用できます。次のメソッド...

設計時にコードの課題を検出する

ReSharperは、エディターでコード・ファイルを開くとすぐに分析を開始し、最後まで編集を続けます。検出されたすべてのコードの課題は、重大度に従ってエディターで強調表示されます。課題のマップは、エディターウィンドウの右側のマーカーバーにも表示されます。ここでは、ファイルのステータスを即座に確認し、...