ReSharper 2026.1 Help

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

ライブ / 囲みテンプレートは、 既存のファイル内にコードを生成するために使用したり、(テンプレート本体に $SELECTION$ パラメーターがある場合) try...catch ステートメントなどの テンプレートコードでコードフラグメントを囲むために使用したりできます。

各ライブテンプレートは、 ショートカット — 例えば foreach — のような短い文字列で識別されます。エディターで直接入力するとテンプレートを呼び出せます。

ライブ / 囲みテンプレートは、単体テスト用のクラス、DTO、スケルトンの作成など、さまざまな用途に使用できます。

ライブ / 囲みテンプレートの本体は、そのまま表示されるプレーンテキストと パラメーターで構成されています。 アイデアは、これらを組み合わせてテンプレートを呼び出すときの効率を最大化することです。

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

  1. メインメニューから ReSharper | ツール | テンプレートエクスプローラー ... を選択します。

  2. 表示される テンプレートエクスプローラーウィンドウ で、 ライブテンプレート または 囲みテンプレート タブをクリックします。

  3. オプションで、特定の 設定レイヤーにテンプレートを作成する場合は、 リストで目的のレイヤーを選択します。 詳細については、 テンプレートの保管 を参照してください。

  4. 新規テンプレート ThemedIcon.AddLiveTemplate.Screen.(グレー).png をクリックします。 新しく作成されたテンプレートが テンプレートエディター で開かれます。

  5. ショートカット フィールドにテンプレートのショートカットを指定します。 テンプレートを素早く呼び出す際に役立ち、 テンプレートからコードを作成するとき補完リストにも表示されます。 説明 フィールドにテンプレートの説明(任意)を入力します。

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

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

    ReSharper: テンプレートのスコープを選択する
  7. 必要なコードを入力または貼り付け、parameters と組み合わせてテンプレートの本体を作成します。

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

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

    ご覧のとおり、 ハイライトが異なる 3 種類の要素があります。

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

    • 事前定義された parameter — この例では、 $END$ parameter により、テンプレートの適用完了後にキャレットを配置する場所を ReSharper に指示します。

    • ユーザー定義 parameter — parameter($ で始まり終わる)を入力すると、テキストエリア右側の パラメーター セクションで利用できるようになります。 テンプレートパラメーターを宣言する セクションに記載されている通りに、定義済みの parameters をすべて設定できます。

      この場合、呼び出し時にクラス名を設定するために、 $className$$ を parameter にします。 Id をどの型にするかわからないため、 $idType でも同じことが起こります。 最後に、 Id プロパティがあります。 クラス名に似せたいので、「Id」が付いた対応する parameter を使用するだけです。

    $className$$ パラメーターの異なるハイライト(赤と黒のフレーム)は、テンプレートが呼び出されたときに ホットスポットセッション にあるときに赤い入力が初期入力位置として使用されることを意味します。

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

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

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

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

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

    • 整形 チェックボックスを選択すると、ReSharper が フォーマット環境設定に従って展開したコード箇所を自動で整形します。

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

  11. テンプレートを保存するには、Visual Studio メニューで ファイル | 選択した項目を保存 を選ぶか、 Ctrl+S​ を押してください。

2026 年 6 月 12 日