ライブ / 囲みテンプレートを作成する

新しいライブ / 囲みテンプレートを作成する

1. 作成されたテンプレートが適用される言語に応じて、JetBrains Rider 設定 Ctrl+Alt+S のエディター | ライブテンプレート | [Language] ページを開きます。

2. 新規テンプレート をクリックします。

3. ショートカットフィールドでテンプレートのショートカットを指定します。テンプレートからコードを作成するときにテンプレートをすばやく呼び出すために使用されます。補完リストにも表示されます。説明フィールドに、テンプレートのオプションの説明を入力します。

4. テンプレートのデフォルトのスコープを変更するには、「使用可能」ボタンをクリックします。表示されるダイアログで、チェックボックスを使用して、新しいテンプレートを適用できる場所を定義します。一部のスコープを拡張して詳細 (ファイルマスクや言語バージョンなど) を指定できます。

   テンプレートが非システムアセンブリのクラスとメソッドを使用する場合、これらのアセンブリを参照するプロジェクトでのみテンプレートを使用できるようにすることができます。グローバルカテゴリで、リファレンスを選択し、.dll 拡張子なしでアセンブリ名を指定します。

   

5. 目的のコードを入力または貼り付け、変数と混合して、テンプレートの本体を作成します。

   例: テンプレート本体は次のようになります。

   public class $className$ { public $idType$ $className$Id {get; set;} $END$ }

   ご覧のとおり、3 種類の要素があります。

   • text — テンプレート本文にプレーンテキストとして記述されたものはすべて、テンプレートを呼び出すとそのまま表示されます。

   • 事前定義された変数 — この例では、$END$ 変数は、テンプレートの適用が完了したらキャレットをどこに配置するかを JetBrains Rider に伝えます。

   • ユーザー定義変数 — 変数（接頭辞と接尾辞に $ が付く）を入力するとすぐに、変数の編集ダイアログで使用できるようになります。テンプレート変数を宣言するセクションに従って、定義されているすべての変数を設定できます。

     この場合、呼び出し中にクラス名を確立するために、$className$$ を変数にします。Id をどの型にするかわからないため、$idType でも同じことが起こります。最後に、Id プロパティがあります。クラス名に似せたいため、「Id」という接尾辞が付いた対応する変数を使用します。

6. で使用セレクタを使用して、テンプレートを新しいコードの生成、既存のコードの囲み、その両方に使用できるかどうかを指定します。作成したテンプレートを周囲のコードに使用する場合は、テンプレートを呼び出す前にユーザーが選択したテキストを表す $SELECTION$ パラメーターを追加します。

7. ニモニックフィールドでは、コードをテンプレートで囲むときに使用する [0-9] 数字を指定できます。

   • いくつかのニーモニック数字が指定されている場合、そのテンプレートは Alt+Enter を押して選択すると囲む ... で使用可能になります。

   • Ctrl+Alt+T を押すと (またはメニューからコード | 囲む…を選択すると)、指定したニーモニック数字がテンプレートの横に表示されます。対応するキーを押すと、このテンプレートをすぐに適用できます。

8. テンプレートのフォーマットオプションを設定する:

   • 再フォーマットチェックボックスを選択して、JetBrains Rider がフォーマット設定に従って展開されたコードフラグメントを自動的に再フォーマットするようにします。

   • 修飾された参照を短くするチェックボックスを選択すると、JetBrains Rider が名前空間インポートディレクティブを自動的に挿入するか、テンプレートの適用後に冗長になる修飾子を削除します。このチェックボックスが選択されていない場合、JetBrains Rider はネームスペースインポートディレクティブを挿入しません。

9. 設定ダイアログで保存をクリックして変更を適用し、JetBrains Rider が変更を保存する場所を選択できるようにするか、保存セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「レイヤーベースの設定」を参照してください。