インレイヒント

インレイヒントは、コードの読みやすさを向上させる、構成可能なエディターの装飾です。

プッシュヒントモード

インレイヒントは便利ですが、一方で、エディターのスペースを占有し、場合によっては冗長に見えることがあります。インレイヒントを必要に応じて表示するには、プッシュヒントモードを使用します。このモードでは、ヒントを非表示にしておき、必要なときにのみ表示することができます。

キーを押すとインレイヒントを表示する

アプリケーションのフォーカスがエディターにあることを確認します。
Ctrl を 2 回押し、2 回目に押したままにしてください。押し続けている間、インレイヒントが表示されます。
Ctrl キーを離した後もインレイヒントを表示し続けたい場合は、エディターの右上隅にある該当するアイコンをクリックしてください：
インレイヒントの表示を停止するには、プッシュヒントアイコンをもう一度クリックします。

インレイヒントをすべてのエディタータブで常に表示または非表示にしたい場合は、デフォルトの可視性セレクターを ReSharper オプションの環境 | インレイヒント | 一般ページで使用してください Alt+R、O。デフォルトの表示設定に何を選択しても、環境 | インレイヒントの対応する設定ページで特定の種類のヒントに対してそれを上書きできます。

Ctrl キーの長押しやダブルプレスが OS や他のアプリケーションで他のアクションに既にバインドされている場合、プッシュヒントを使っていなくても ReSharper がそれらのマッピングをオーバーライドします。これを回避するには、ReSharper オプションの環境 | インレイヒント | 一般ページで Ctrl キーを 2 回プッシュしたままにして、プッシュヒント機能を使用するチェックボックスをオフにしてください Alt+R、O。

パラメーター名ヒント

メソッド呼び出しで名前付き引数を記述する代わりに、ReSharper のパラメーター名ヒント（メソッド呼び出し時に対応する引数の横にパラメーター名を表示するエディター装飾）を利用できます。

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

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

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

ReSharper: インラインパラメーター名のヒントは、メソッド呼び出しの引数を理解できます

パラメーター名ヒントは、インテンションが明確でない引数にパラメーター名を表示しつつ、目的が明らかな引数や呼び出し内に名前付き引数がある場合はエディターをヒントで煩雑にしないように配慮しています。これを実現するため、ReSharper は複数の設定可能なヒューリスティックを適用します。

型名のヒント

型名のヒントは、異なるコンテキストで変数と式が持つ型を理解できます。たとえば、次のようになります。

匿名型
ラムダ式のパラメーター
コールチェーンでメソッドのタイプを返します。

他の多くの場合。

必要に応じて、特定のケースごとにタイプ名のヒントを設定できます。

型変換のヒント

型変換のヒントは、コード内の暗黙的な型変換を示しています。

下記の例で、 Vector3D から Vector2D への変換時に（Z の値が）暗黙的に失われ、このヒントによりその箇所がわかります。

コード分析のヒント

インレイヒントを使用すると、不足している関数の戻り値とスイッチステートメントの不足しているブレークを表示できます。これにより、何が欠落しているかをすぐに理解できます。

インレイヒントを使用して、リソース変数が破棄される場所を確認できます。

呼び出しコードで [MustDisposeResourceAttribute] （JetBrains.Annotations ）を使ってリソースの破棄を強制している場合、ReSharper では破棄可能なリソースを返すコンストラクターやファクトリメソッドを視覚的に識別できます：

ReSharper インレイヒント: MustDisposeResourceAttribute

これらのヒントの表示を設定するには、ReSharper オプションの環境 | インレイヒント | C# | その他ページ Alt+R、O で該当するセレクターをご利用ください。

C# 迎撃機のインレイヒント

インレイヒントは、インターセプトされた呼び出しを特定するのに役立ち、さらに Alt+Enter または Ctrl +ヒントアイコンをクリックしてインターセプターメソッドへ移動できます：

ReSharper: インターセプトされたメソッドのインレイヒントとナビゲーションアクション

インターセプターメソッドの [InterceptsLocation](英語) アノテーションには、インターセプトされた呼び出しに移動するためのヒントが含まれています。

これらのヒントの表示を設定するには、ReSharper オプションの環境 | インレイヒント | C# | インターセプターヒントページ Alt+R、O で該当するセレクターをご利用ください。

名前のない構成要素のインレイヒント

タプルコンポーネント名がコンポーネント式から明らかでない場合、インレイヒントとしてタプルコンポーネント名を表示できます。

インレイヒントは、コンポーネントの宣言された名前を表示することにより、分解パターンの読みやすさを大幅に向上させることができます。

メソッドが必要以上の変数を返し、その一部が _ で破棄された場合、インレイヒントは何が破棄されたかを確認できます。デフォルトでは、破棄のヒントはプッシュヒントで機能します。

「#pragma warning」のヒント

#pragma warning ディレクティブを使用すると、ID に基づいて特定の警告を無効にしたり復元したりできます。各 ID の意味を覚えるのは難しいため、ReSharper は警告説明付きのインレイヒントを追加できます。この種のヒントは、ID が CS で始まるコンパイラー警告でのみ機能することに注意してください。

ReSharper: 「#pragma warning」ディレクティブのインレイヒント

後続のローカル関数のヒント

コードブロックの最後にローカル関数を配置するのが一般的ですが、そのようなブロックを読み取るときは、多くの場合、ローカル関数定義を過ぎてスクロールして、その後に実行可能コードがないことを確認する必要があります。

このような場合の可読性を向上させるため、ReSharper では return; や continue などの暗黙的な制御フローマーカーを可視化したり、ブロックに実行可能なコードがない場合に //Local Functions だけを表示するインラインヒントを提供します。

閉じ括弧のヒント

大きなコードブロックの末尾では、右波括弧が何を表すかが不明確な場合があります。右波括弧は入れ子型やメソッド、複雑なステートメントの終了を示すことがあります。インレイヒントは、それぞれの右波括弧が何の終わりなのかを表示することで、コード構造を素早く明確にできます：

視覚的なノイズを減らすために、これらのヒントは 10 行を超えるブロックに対してのみ、またキャレットが閉じ括弧に設定されている場合にのみ表示されます。

これらのヒントを有効化または無効化するには、ReSharper オプションの環境 | エディター | 外観ページ Alt+R、O でインレイヒントを使用して、一致するブロックのヘッダーを表示します ... チェックボックスをご利用ください。

インレイヒントの構成

インレイヒントの切り替えや構成は、ReSharper オプションの環境 | インレイヒントページ Alt+R、O 配下の該当する設定ページで行えます。

インレイヒントを使用しない場合は、環境 | インレイヒント | 一般設定ページのインレイヒント有効化チェックボックスをオフにすることで無効にできます。 ReSharper はヒントの計算を停止するため、一部リソースの節約に繋がります。

ただし、特定の種類のヒントのみを表示する場合は、そのページのデフォルトの可視性セレクターを表示しないに設定してから、目的の種類のヒントの可視性セレクターでこれをオーバーライドできます。

パラメーター名のヒントについては、特定のパターンに一致するメソッドのヒントをさらに非表示にすることができます。そのためには、ReSharper オプションの環境 | インレイヒント | [language] | パラメーター名ヒントページ Alt+R、O の下部にこれらのパターンを追加してください。

パターンの例を次に示します。

System.Math.* は、FQN が System.Math で始まるすべてのメソッドに一致します。
System.Math.*(*, *) は、 System.Math 名前空間のすべてのメソッドを 2 つのパラメーターと照合します。
(*info) は、パラメーター名が info で終わるすべての単一パラメーターメソッドに一致します
(key, value) は、すべてのメソッドとパラメーター key および value を一致させます。
Put(key, value) は、パラメーター key および value を持つすべての Put メソッドに一致します。

キャレットがインレイヒントのあるコードアイテムにある場合、 Alt+Enter を押してインレイ名のヒントを構成するを選択するか、代わりにパラメーターヒントを右クリックして、次のいずれかのコマンドを選択できます。

メソッドのすべての呼び出しのパラメーターヒントを非表示にするか、現在のアイテムに適用される名前ヒントを入力します（無効にしたヒントを表示する場合は、オプションページで対応するアイテムまたは例外パターンを見つけて削除できます）。
この種のヒントの表示を変更する
インレイヒントを完全に無効にします（後でオプションページで有効にできます）。
詳細設定のオプションページを開きます。