ReSharper 2024.1 ヘルプ

テンプレートエディター

テンプレートエディターは、コードテンプレートの作成編集に役立ちます。テンプレートエディターが新しいドキュメントタブで開き、テンプレートとアプリケーションコードを切り替えて、作成したテンプレートをすばやくテストできます。

ReSharper Template editor

テンプレートエディターは、キーワード、コメントなどの基本的なコードのハイライトを提供します。すべてのハイライト色は構成可能です。

テンプレートエディターの強調色を構成する

  1. メニューからツール | オプションを選択して、環境 | フォントと色ページに移動します。

  2. アイテムを表示するリストで、ReSharper テンプレートエディターで始まる項目を見つけます。

  3. アイテムフォアグラウンドセレクタを使用して、選択した項目の色を選択します。

テンプレートエディターのコントロールは、次の 2 つの表で説明する 2 つの論理グループに分けることができます。

テンプレートオプション

項目

説明

ショートカット

ライブテンプレートで利用できます。

ライブテンプレートを呼び出すためにソースコードに入力できるショートカット(省略形)。

説明

サラウンドテンプレートとファイルテンプレートの場合、これはテンプレートを選択して適用しようとしたときにドロップダウンリストに表示される識別子です。ライブテンプレートの場合、これは補完リストにテンプレートショートカットと共にポップアップ表示されるオプションの説明文字列です。

デフォルトファイル名

ファイルテンプレートで使用できます。

ファイルテンプレートを適用するときに ReSharper がプロンプトを表示するデフォルト名。

ファイル名は有効な識別子でなければなりません

ファイルテンプレートで使用できます。

このチェックボックスにより、ReSharper は、テンプレートの適用時に指定されたファイル名がタイプ識別子として有効かどうかをチェックします。このオプションは、テンプレートが新しいタイプのファイルを作成し、タイプ名が現在の拡張子のないファイル名 マクロを使用して提供されたファイル名から初期化される場合に役立ちます。事前定義されたファイルテンプレートをチェックして、それがどのように実装されているかを確認できます。

修飾された参照を短くする

このチェックボックスにより、ReSharper は自動的にネームスペースインポートディレクティブを挿入するか、テンプレートの適用後に冗長になる修飾子を削除します。このチェックボックスが選択されていない場合、ReSharper はネームスペースインポートディレクティブを挿入しません。

再フォーマット

このチェックボックスを使用すると、ReSharper は、フォーマット設定に従って、展開されたコードフラグメントを自動的に再フォーマットします。

使用可能

このハイパーリンクが表示され、テンプレートのスコープを変更できます。

新しいファイルを追加

ファイルテンプレートで使用できます。

このボタンは、新しい空のファイルをマルチファイルテンプレートに追加します。

既存のテンプレートからファイルを追加する

ファイルテンプレートで使用できます。

このボタンは、既存のファイルテンプレートへの参照によって、マルチファイルテンプレートに新しいファイルを追加します。

テンプレートパラメーター

項目

説明

パラメーター名

テンプレート本体で定義されているテンプレートパラメーターの名前。

マクロを選択または [ マクロの名前 ]

このハイパーリンクは、パラメーター値を計算するマクロを表示または選択できるようにします。このハイパーリンクをクリックすると、マクロを選択ダイアログでマクロを選択できます。選択したマクロにマクロパラメーターがある場合は、ダイアログに太字で表示されます (たとえば、format または type)。この場合、マクロを選択すると、テンプレートパラメーターにテキストフィールドまたはセレクタが表示されます。そこにマクロパラメーターを指定できます。

編集可能または編集可能な出現箇所セレクタ

これらのコントロールを使用すると、次のいずれかの方法でパラメーターを編集可能にすることができます。

  • パラメーターがテンプレートで一度だけ使用されている場合は、チェックボックスが選択されていることを確認してください。

  • パラメーターがテンプレートで複数回使用されている場合は、コンボボックスが表示され、編集可能な出現箇所の連番を選択できます。この番号は、テンプレートがホットスポットセッションでデプロイされたときに、入力フォーカスが設定されるパラメーターの出現箇所を指定します。また、数字の前に「M」またはその他の文字が付いていることに気付くかもしれません。これらの文字は、マルチファイルテンプレートのどのファイルで、このパラメーターに入力フォーカスを設定する必要があるかを定義します。「M」はメインファイルを表し、すべてのテンプレートに表示されます。

上へ移動 / 下へ移動

パラメーターを選択すると、これらのボタンを使用してパラメーターの順序を変更できます。パラメーターのリスト内の位置は、テンプレートが適用されたときのホットスポットセッション中にパラメーターが切り替えられる順序を定義します。これは編集可能なパラメーターにのみ影響します。

関連ページ:

ライブ / サラウンドテンプレートを作成する

ライブ / サラウンドテンプレートは、既存のファイルにコードを生成したり、(テンプレート本体にパラメーターがある場合)ステートメントなどのテンプレートコードでコードフラグメントを囲むために使用できます。各ライブテンプレートは、ショートカット(などの短い文字列)によって識別されます。この文字列をエディターに直接入力して、テンプレートを呼び出すことができます。ライブ / サラウンドテンプレートは、単体テスト用のクラス、DTO、スケルトンの作成など、さまざまな用途に使用できます。ライブ / サラウンド...

テンプレートの編集

テンプレートエクスプローラーウィンドウにあるすべてのテンプレートは、ニーズと開発プラクティスに従って編集できます。テンプレートの本文を編集したり、ライブテンプレートのショートカットやすべてのテンプレートの説明を変更したり、テンプレートのスコープを変更したり、テンプレートパラメーターを導入または変更したりできます。コードテンプレートを編集する前に、ReSharper がどのように格納するかを検討することをお勧めします。異なるテンプレートを異なる設定レイヤーに保存できるだけでなく、テンプレートへの変...

テンプレートからファイルを作成する

ReSharper を使用すると、ファイルテンプレートに基づいてクラス、インターフェース、構造体、その他のファイルを作成できます。作成されると、新しいファイルがプロジェクトに追加され、エディターで開きます。このファイルには、テンプレートで指定されたソースコードが含まれています。テンプレートから新しいファイルを作成する以下のいずれか 1 つを実行します: ソリューションエクスプローラーでは、テンプレートから新しいファイルを作成するノードを選択します。エディターで開いているコードファイルにキャレットを...

フォーマットルールを構成する

フォーマットルールは非常に高いレベルの詳細に設定できます。例: 特定の演算子の周囲に空白を配置するか、入れ子になった文をインデントするかを定義できます。オプションでコードフォーマットルールを構成するメインメニューからを選択するか、Alt+R O を押します。ページを使用して、すべての言語で適用されるオプションを確認し、設定します。ページを使用して、言語固有のフォーマットを構成します。これらのページでは、下部にあるプレビュー領域を使用して、ReSharper がコードに特定の設定を適用する方法を表示...

テンプレートスコープ

ReSharper は、コードテンプレートを利用できる範囲をいくつか定義します。スコープは、特定のコードテンプレートの使用を関連するコンテキストに限定できます。例: 定義済みのライブテンプレート itar(配列の反復) は、デフォルトで C# 2.0+ ステートメントで使用できます。これは、この特定のスコープがこのテンプレートに対して定義されていることを意味します。itar テンプレートは C# ステートメントの本文に適用できますが、メンバーの外側の C# クラスの本文や、たとえば XML ファイルに...

テンプレートエクスプローラーウィンドウ

テンプレートエクスプローラーウィンドウには、すべてのコードテンプレートが一覧表示され、作成、編集およびコードテンプレートの管理に必要なコントロールが提供されます。このウィンドウには、3 種類の ReSharper テンプレートを管理するための 3 つのタブがあります。ライブテンプレート:このタブはライブテンプレートを管理するために使用されます。さまざまな言語で利用可能なテンプレートを参照できます。左側にはテンプレートスコープとユーザーカテゴリがあり、右側には選択したスコープとカテゴリでフィルター...