ReSharper 2024.1 ヘルプ

テンプレートパラメーターを宣言する

コードテンプレートは、周囲のコンテキストに合わせて調整したり、適用時にインタラクティブに動作したりすることもできます。これはすべて、テンプレートパラメーターテンプレートマクロを使用して行われます。

テンプレートエディターでテンプレートパラメーターを定義および編集できます。パラメーター(接頭辞と接尾辞が $)を入力するとすぐに、テキスト領域の右側のパラメーターセクションで使用できるようになります。次に、マクロを選択をクリックしてその動作を構成できます。

ReSharper: Template editor

テンプレート内の任意のパラメーターを複数回使用できます。それらの値は、テンプレートが適用されるときに同期されます。

テンプレートパラメーターを宣言する

  1. テンプレートの新規作成または既存のテンプレートを開いて編集します。

  2. テンプレートエディターのテキスト領域にパラメーター $parameter_name$ を入力します。

  3. パラメーター値を計算するマクロを定義するには、テキスト領域の右側にあるパラメーターセクションでパラメーターを見つけて、マクロを選択をクリックします。マクロがすでに定義されている場合は、そのハイパーリンクをクリックして別のマクロに切り替えることができます。

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

    ReSharper: Choose macro dialog
  5. パラメーターを編集可能にする場合は、その横にある編集可能チェックボックスを有効にする必要があります(デフォルトでは有効になっています)。テンプレート内のパラメーターの出現回数に応じて、次のいずれかを実行します。

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

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

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

  7. テンプレートを保存するには、Visual Studio メニューでファイル | 選択した項目を保存を選択するか、Ctrl+S を押します。

関連ページ:

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

コードテンプレートの本体には、次のものが含まれます。ソースコードの構造とコメントを表すプレーンテキスト。テンプレートを適用するとそのまま挿入されます。テンプレートを適用すると動的に置き換えられるテンプレートパラメーター。テンプレートパラメーターの形式は次のとおりです。- ここで、は任意の識別子です。形式が正しい場合、テンプレートエクスプローラーウィンドウは事前定義されたパラメーターを濃い青でハイライトし、その他のパラメーターを濃い赤でハイライトします。定義済みのパラメーター:次のテンプレートパ...

テンプレートエディター

テンプレートエディターは、コードテンプレートの作成と編集に役立ちます。テンプレートエディターが新しいドキュメントタブで開き、テンプレートとアプリケーションコードを切り替えて、作成したテンプレートをすばやくテストできます。テンプレートエディターは、キーワード、コメントなどの基本的なコードのハイライトを提供します。すべてのハイライト色は構成可能です。テンプレートエディターの強調色を構成するメニューからを選択して、ページに移動します。アイテムを表示するリストで、ReSharper テンプレートエディター...

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

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