テンプレート変数

定義済みの変数

次のテンプレート 変数s は、JetBrains Rider で事前に定義されています：

• $END$ — テンプレートが適用された後のキャレットの位置。

• $SELECTION$ — テンプレートを呼び出す前にユーザーが選択したテキスト。 この 変数 は、 囲みテンプレートでのみ使用されます。

• $SELSTART$ — テンプレートの適用 後に選択されるテキストブロックの開始位置。

• $SELEND$ — テンプレートの適用 後に選択されるテキストブロックの終了位置。

ユーザー定義変数

テンプレートを作成または編集するときに、他のすべての 変数s を 任意の識別子で定義できます。 通常、テンプレートが適用されるときに 変数s の値を計算 するためのマクロを用意する必要があります。

また、各 変数 を編集可能にして、 テンプレートの適用時にユーザーが値を変更できるようにすることもできます。

編集可能な変数

コード テンプレートに編集可能な 変数s がない場合、ユーザーの操作なしで即座に適用されます。編集できない 変数s が存在する場合、それらはすべて マクロ によって自動的に計算されます（例えば、固定値、現在の名前空間、型名、またはクリップボードの内容を挿入するなど）。

テンプレートコードをソースコードに挿入した後、テンプレート開発者が $END$ または $SELEND$ 変数s で指定した位置に入力を再開しますが、挿入されたコードの一部を変更する必要がある場合は、戻って編集することができます。

一方、編集可能な 変数s は、変更が必要なフィールドを表示し、多くの場合、基礎となるマクロによって妥当な選択肢が提案されます。 JetBrains Rider に慣れていくと、多くの定義済みテンプレートに編集可能な 変数s があることに気づきます。 編集可能な 変数s を使ったカスタム テンプレートの作成や編集方法については、 テンプレートを作成および編集する セクションもご参照ください。

例：コンテナーのすべての要素に対する反復のためにうまく設計されたテンプレートは、編集可能な 変数s を使って次のように選択できます：

• ループ索引変数の適切な名前（たとえば、 i または j）。

• 反復されたコンテナーの式として、現在のスコープ内の指定された型（たとえば、配列またはリスト）のすべての変数のリスト。

• 反復中に現在のコンテナー要素を保持する、割り当てられた変数の適切な名前。

• 反復されたコンテナー内の要素の型。

編集可能な 変数s を含むテンプレートが適用されると、JetBrains Rider はエディターに ホットスポットセッション をデプロイします。 このセッションでは、すべての 変数s の値を段階的に指定または選択できます。 変数s を自分の入力に置き換えるか、提案された値のいずれかを受け入れることができます。

編集可能な 変数s を含むテンプレートを適用する例は、 ライブテンプレートを使用したソースコードの作成  および テンプレートで周囲のコード箇所セクションに示されています。