ReSharper 2019.2ヘルプ

テンプレートパラメータの宣言

コードテンプレートは周囲の状況に合わせて調整したり、適用したときに対話的に動作したりすることもできます。これはすべてテンプレートパラメータとテンプレートマクロで行われます。

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

ReSharper: Template editor

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

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

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

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

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

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

  5. パラメータを編集可能にする場合は、その横にある編集可能チェックボックスを有効にします(これがデフォルトです)。テンプレート内のパラメータの出現数に応じて、次のいずれかを実行します。
    • パラメータがテンプレートで一度だけ使用されている場合は、チェックボックスが選択されていることを確認してください。

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

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

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

最終更新日: 2019年8月20日

関連事項

関連ページ:

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

コードテンプレートの本体には、次のものが含まれます。ソースコードの構造とコメントを表すプレーンテキスト。テンプレートを適用するとそのまま挿入されます。テンプレートを適用すると動的に置き換えられるテンプレートパラメータ。テンプレートパラメータの形式は次のとおりです。-は任意の識別子です。フォーマットが...

テンプレート・エディター

テンプレート・エディターはコードテンプレートの作成と編集を手助けします。テンプレートエディターが新しいドキュメントタブに表示されるため、テンプレートとアプリケーションコードを切り替えて、作成したテンプレートをすばやくテストできます。テンプレートエディターは、キーワード、コメントなどの基本的なコード強...

ライブ/サラウンドテンプレートの作成

ライブ/サラウンドテンプレートは、既存のファイルでコードを生成したり、(テンプレート本体にパラメーターがある場合)、ステートメントなどのテンプレートコードでコードフラグメントを囲むために使用できます。各ライブテンプレートはショートカット(foreachなどの短い文字列)で識別され、テンプレートを呼び...

テンプレートの編集

テンプレートエクスプローラーウィンドウで見つけることができるすべてのテンプレートはあなたのニーズと開発習慣に従って編集することができます。テンプレートの本文を編集したり、ライブテンプレートのショートカットやすべてのテンプレートの説明を変更したり、テンプレート範囲を変更したり、テンプレートパラメータを...

マクロダイアログを選択

このダイアログは、ReSharperが各テンプレートパラメータの値を推奨または推測するために使用するテンプレートマクロを指定できます。このダイアログは、テンプレートパラメータを宣言または編集するときに使用します。このダイアログには、以下で説明する一連のテンプレートマクロが含まれています。変数で表され...

ホットスポットセッション

多くのReSharper機能は、エディター内のコードブロックを挿入または置換します。このブロックを完成させるためにユーザー入力が必要な場合は、コードブロックが挿入された直後にReSharperが利用可能なすべての提案や変更を案内するように、これらの機能は対話的に動作することがよくあります。この場合、...