コードの構文スタイル: 名前付き / 位置引数
特定の型のパラメーターに名前付き引数を使用したい場合は、ReSharper を使用するとこの方法を実行できます。
次のメソッド呼び出しを考えてみましょう。
このコードを読むときは、メソッドシグネチャーを停止して調査し、ここで何が起こるかを理解する必要があります(パラメーター情報のツールチップを使用するか、メソッド宣言に移動することで実行できます)。名前付き引数を使用すると、同じ呼び出しがより明確になります。
特定の型に対して名前付き引数を使用したい場合は、ReSharper を使用してこの優先順位を適用することができます。
ReSharper は、既存のコードで引数を調整するのに役立ち、コード補完およびコード生成機能を使用して新しいコードを生成し、コードテンプレートを適用し、リファクタリングを実行するときに設定を考慮します。
引数にスタイル設定を適用する
デフォルトでは、ReSharper はどこでも位置引数を使用することを提案しており、名前付き引数を必要とするパラメーターの型を明示的に指定する必要があります。設定に応じて、ReSharper は、名前を必要とする位置引数または位置でなければならない名前付き引数をハイライトし、対応するクイックフィックスまたはスコープ内の修正を提案します。
引数のスタイル設定がない場合でも、名前付き引数または位置引数で Alt+Enter を押すと、対応するコンテキストアクションで引数名を追加または削除できます。
バルクモードで名前付き / 位置引数の設定を強制する別のオプションは、コードのクリーンアップです。組み込みプロファイルフルクリーンアップまたは再フォーマットして構文スタイルを適用のいずれかを使用してコードクリーンアップを実行するか、以下で説明するように、特定のタスクのみを対象としたカスタムプロファイルを作成して実行できます。
カスタムコードクリーンアッププロファイルで引数スタイルを適用する
メインメニューから Alt+R O を押します。
を選択するか、クリーンアッププロファイル設定ページに移動します:
。新しいカスタムクリーンアッププロファイルを作成するセクションの説明に従って、新しいプロファイルを作成します。新しいプロファイルの選択したプロファイル設定セクションで、引数のスタイルを適用するチェックボックスをオンにします。必要に応じて、このプロファイルで他のコードクリーンアップタスクを有効にすることができます。
オプションダイアログで保存をクリックして変更を適用し、ReSharper に変更を保存する場所を選択させるか、保存先セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「resharper 設定の管理と共有」を参照してください。
設定を適用する範囲を選択します。
ファイル内の任意の場所にキャレットを配置して、ファイルに設定を適用します。
ソリューションエクスプローラー内の 1 つまたは複数の項目を選択して、これらのノードおよびその子項目にあるファイルに設定を適用します。
以下のいずれか 1 つを実行します:
Control+Alt+F を押すか、メインメニューから
を選択してください。テキストエディターの任意の場所を右クリックするか、選択項目を右クリックし、コンテキストメニューでコードのクリーンアップを選択します。
開いたコードのクリーンアップダイアログで、新しく作成したプロファイルを選択します。
実行をクリックします。ReSharper は、選択した範囲であなたの設定を強制します。
コードのクリーンアップダイアログを開いてプロファイルを選択せずに引数を調整する場合は、作成したプロファイルをサイレントクリーンアップにバインドし、Control+Shift+Alt+F を押して実行できます。引数の配置と他のコードスタイルタスクを組み合わせたカスタムクリーンアッププロファイルを作成することもできます。
名前付き / 位置引数の環境設定を他のすべてのフォーマットおよび構文スタイルのルールとともに選択したコードブロック Alt+Enter に適用するには、 を選択します。
変更をファイルに保存するたびに引数を調整して、編集内容が常にコードスタイルに準拠するようにすることができます。
変更の保存に関する引数を自動的に配置する
メインメニューから Alt+R O を押します。
を選択するか、クリーンアッププロファイル設定ページに移動します:
。カスタムコードクリーンアッププロファイルを選択し、デフォルトに設定をクリックします(デフォルトプロファイルはサイレントクリーンアップにも使用されます)。
ファイルの保存時にクリーンアップを自動的に実行するを選択します。
オプションページに移動し、オプションで、ファイルマスクによって特定のファイルへの自動クリーンアップを制限できます。
ファイルの変更された部分のみを選択して、変更によって影響を受けるコードにクリーンアップが適用され、ファイル内の残りのコードが変更されないようにすることもできます。
ファイルの変更された部分のみをクリーンアップすることを選択した場合は、次のオプションを使用してこの動作を微調整できます。
部分的なクリーンアップが不可能な場合は完全なクリーンアップを実行する — このオプションに応じて、ReSharper はファイル全体をクリーンアップするか、ファイルの変更された部分のみにクリーンアップを制限できない場合はファイルをスキップします。
共有ファイルの保存時にクリーンアップを許可する — このオプションを使用して、共有プロジェクトのファイルなど、ソリューションに複数回含まれるファイルの部分的なクリーンアップを有効または無効にします。
ダイアログで保存をクリックして変更を適用し、ReSharper に変更を保存する場所を選択させるか、保存先セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「resharper 設定の管理と共有」を参照してください。
次回編集を終了してファイル (Ctrl+S) またはすべてのファイル (Ctrl+Shift+S) を保存すると、ReSharper は選択したプロファイルを使用して影響を受けるファイルをクリーンアップします。デフォルトのクリーンアッププロファイルが選択されていない場合、ReSharper はプロファイルの 1 つを選択するように求めます。
名前付き / 位置引数の設定を構成する
引数のスタイル設定は、レイヤーベースの設定のメカニズムを使用して保存されます。とりわけ、このメカニズムにより、さまざまなソリューションのさまざまな設定を維持したり、これらの設定を VCS に保持したり、チームメンバーと自動的に共有することができます。
引数スタイルの設定を構成する
ReSharper オプション Alt+R, O の ページに移動します。
引数カテゴリで、特定のパラメーター型に名前付き引数と位置引数のどちらを使用するかを選択します。リテラル値は、文字列を除くすべてのリテラル(
bool
、int
、double
など)を参照することに注意してください。文字列の設定は、文字列リテラル値セレクターで定義されます。カテゴリその他は、条件式、NULL 合体式、バイナリ式、呼び出し式、
typeof
式など、他のすべての式タイプに適用されます。右側の列の通知するセレクターを使用して、設定とは異なるコードインスペクション検出コードの重大度レベルを設定できます。
オプションダイアログで保存をクリックして変更を適用し、ReSharper に変更を保存する場所を選択させるか、保存先セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「resharper 設定の管理と共有」を参照してください。
また、エディターで引数を整理するための設定を変更することもできます。ここでは、対応する問題がハイライトされています。
エディターで名前付き / 位置引数の設定を変更
ReSharper のインスペクションでハイライトされているコードの問題にキャレットを置きます。
Alt+Enter を押すか、キャレットの左側にあるアクションインジケーターをクリックして、アクションリストを開きます。
アクションリストで、インスペクション " 優先引数スタイルを使用してください ..." | コードスタイルを設定するを選択し、希望のオプションを選択します。
変更は、スマートセーブロジックを使用して保存されます。
変更したスタイル設定を共有設定レイヤーに保存する必要がある場合は、コードスタイルを設定するメニュー項目をクリックするか、選択時に Enter を押します。ReSharper により、ReSharper オプションの ページが開きます。必要に応じて設定を変更し、保存先をクリックして、目的の設定レイヤーを選択します。
この機能は、次の言語とテクノロジーでサポートされています。
関連ページ:
パラメーター情報
関数呼び出しを書いたり調べたりするときはいつでも、ReSharper は、関数のすべてのオーバーロードで許可されている引数の詳細を表示できます。ポップアップには、関数の XML ドキュメントから取得したパラメーターと簡単な説明 (利用可能な場合) を含むすべての公開署名が表示されます。パラメーター情報を使用:パラメーターを入力すると、ReSharper は入力されたパラメーターと互換性のある次のシグネチャーを自動的にハイライトし、適用できないシグネチャーをグレー表示します。既存の関数呼び出しの...
宣言に移動
このコマンドを使用して、任意のシンボルの使用箇所からシンボルの宣言に移動します。このコマンドは、ソリューションエクスプローラー、ファイル構造ウィンドウ、その他のツールウィンドウから呼び出すことができます。反対方向(シンボルの使用箇所)に移動するには、すでにシンボル宣言を行っているときに宣言に移動コマンドを呼び出すか、シンボルの使用に移動コマンドを使用できます。シンボルの宣言に移動するキャレットをエディターのシンボルに配置するか、ツールウィンドウでシンボルを選択します。メインメニューで選択するか
インレイヒント
インレイヒントは、コードの読みやすさを向上させる、構成可能なエディターの装飾です。プッシュツーヒントモード:インレイヒントは便利ですが、一方で、エディターのスペースを占有し、場合によっては冗長に見えることがあります。インレイヒントを必要に応じて表示するには、プッシュツーヒントモードを使用します。このモードでは、ヒントを非表示にしておき、必要なときにのみ表示することができます。キーを押すとインレイヒントを表示するアプリケーションのフォーカスがエディターにあることを確認します。Ctrl キーを押し続...
設計時にコードの問題を分析する
ReSharper は、エディターでコードファイルを開くとすぐに分析を開始し、最後まで編集を続けます。検出されたすべてのコードの問題は、重大度に従ってエディターでハイライトされます。問題のマップは、エディターウィンドウの右側のマーカーバーにも表示されます。ここでは、ファイルのステータスを即座に確認し、マークをクリックして特定のコードの問題に移動できます。デザインタイムインスペクションの機能:ReSharper によって実行されるデザインタイムコードインスペクションを説明するために、エディターに...
スコープを修正
クイックフィックスのほとんどは、キャレットの現在の問題を修正できますが、一部 (たとえば、未使用のディレクティブを削除する、フィールドを読み取り専用にする、冗長なキャストの除去など) は、現在のファイル、プロジェクト、フォルダー、ソリューション全体など、より広い範囲で問題を自動的に検出して修正することもできます。範囲内の修正を適用する:このような修正は、アクションリストの横に小さな矢印が表示されることで認識できます。範囲内の修正を適用する ReSharper のインスペクションでハイライトされて...
コンテキストアクション
コンテキストアクションは、エディターで直接利用できるコード変換ヘルパーです。クイックフィックスとは対照的に、コンテキストアクションは問題の解決やコードの改善を目的としているためはなく、アクセス修飾子の変更、null をチェックするコードの生成、'foreach' の 'for' への変換などの小さな変更をすばやく導入できます。ReSharper は、サポートされているすべての言語で数百のコンテキストアクションを提供します。完全なリストは、ReSharper オプション Alt+R, O のページとコ...