ReSharper 2019.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 つを実行します:

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

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

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

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

コードクリーンアップダイアログを開かずに引数を配置したい場合は、デフォルトのコードの再フォーマットプロファイルをサイレントクリーンアップにバインドし、Ctrl+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オプションのコード編集 | C# | コード・スタイルページを開くため、必要に応じて設定を変更し、次へ保存をクリックしてから目的の設定レイヤーを選択します。

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

Language: C#Language: VB.NETLanguage: C++Language: HTMLLanguage: ASP.NETLanguage: RazorLanguage: JavaScriptLanguage: TypeScriptLanguage: CSSLanguage: XMLLanguage: XAMLLanguage: ResxLanguage: Build ScriptsLanguage: ProtobufLanguage: JSON
Feature is availableFeature is not availableFeature is not availableFeature is not availableFeature is not availableFeature is not availableFeature is not availableFeature is not availableFeature is not availableFeature is not availableFeature is not availableFeature is not availableFeature is not availableFeature is not availableFeature is not available
最終更新日: 2019年8月16日

関連事項

関連ページ:

パラメータ情報

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

宣言に移動

このコマンドを使用すると、任意のシンボル使用箇所からシンボルの宣言にナビゲートできます。ファイル構造ウィンドウや他のツールウィンドウからエディターからこのコマンドを呼び出すことができます。反対方向にナビゲートする(シンボルの使用箇所)には、すでにシンボル宣言を行っているときに宣言に移動コマンドを呼び...

コード補完 (IntelliSense)

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

コード生成

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

インライン・パラメータ名のヒント

メソッド呼び出しで名前付き引数を書く代わりに、ReSharperのパラメータ名のヒント- メソッド呼び出しで対応する引数の隣にパラメータ名を表示するエディターの装飾 - を利用することができます。ReSharperでは、コード内で名前付き引数を使用することを提案するコードスタイル設定を構成することも...

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

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