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

定義済みのパラメーター

次のテンプレート parameters は、ReSharper で事前定義されています：

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

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

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

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

ユーザ定義のパラメーター

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

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

編集可能なパラメーター

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

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

一方、編集可能な parameters は、変更可能なフィールドを表示し、多くの場合、マクロによって妥当な選択肢が提示されます。 ReSharper に慣れてくると、多くの定義済みテンプレートに編集可能な parameters が含まれていることが分かります。 また、 テンプレートを作成および編集する セクションで、編集可能な parameters を持つカスタムテンプレートの作成方法や編集方法も学べます。

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

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

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

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

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

編集可能な parameters を持つテンプレートが適用されると、ReSharper はエディターに ホットスポットセッション を展開します。 このセッションでは、すべての parameters の値を段階的に指定または選択できます。 parameters を入力内容で置き換えるか、提案された値を受け入れることもできます。

編集可能な parameters でテンプレートを適用する例は、 ライブテンプレートを使用したソースコードの作成  および テンプレートで周囲のコードフラグメントのセクションに記載されています。