ReSharper 2024.1 ヘルプ

マルチファイルテンプレートを作成する

ファイルテンプレートは、テンプレートを適用するときに複数のファイルを作成できます。これは、関連するデータが別のファイルに保存されている場合に役立ちます。

マルチファイルテンプレートについて知っておくべきことがいくつかあります:

  • ファイルテンプレートには常に 1 つのメインファイルと、オプションで任意の数のセカンダリファイルが含まれます。任意のファイルテンプレートにセカンダリファイルを追加すると、すぐに複数のファイルテンプレートが作成されます。

  • セカンダリファイルを追加するときは、既存のファイルテンプレートを参照できます(既存のテンプレートからファイルを追加するオプション)。参照されるテンプレートにも複数のファイルがある場合は、テンプレートを適用するときに、参照されるテンプレートのメインファイルだけが追加されることに注意してください。

  • パラメーターのセットは、マルチファイルテンプレートのすべてのファイルにおよびます。つまり、マルチファイルテンプレートの複数のファイルで同じパラメーター $PARAM$ を使用する場合、テンプレートが適用されると、関連するすべてのファイルで同じ値になります。

  • 複数ファイルのテンプレートに編集可能なパラメーターがある場合は、このテンプレートを適用するとデプロイされるホットスポットセッションが、ユーザー入力が必要なすべての作成済みファイルを案内します。

ファイルテンプレートに新しいファイルを追加する

  1. 新しいファイルテンプレートを作成するまたは既存のファイルテンプレートを開いて編集します。

  2. テンプレートエディターの下部で、新しいファイルを追加または既存のテンプレートからファイルを追加するをクリックします。新しいセクションがメインファイルの本体に追加されます。

  3. デフォルトでは、新しいセカンダリファイルがメインファイルと同じプロジェクトに追加されます。異なるプロジェクトに追加する場合は、このプロジェクトの名前をプロジェクトフィールドに指定します。指定したプロジェクトが、テンプレートが適用されているソリューションに存在しない場合、セカンダリファイルは追加されません。

  4. セカンダリファイルを別のフォルダーに追加する場合は、フォルダーフィールドで指定します。フォルダー階層には円記号を使用します。いくつかのプロジェクトが指定されている場合、新しいフォルダーパスはこのプロジェクトを基準にしており、そうでない場合はメインテンプレートファイルを基準としていることに注意してください。

  5. セカンダリファイルの名前を指定します。$NAME$ は拡張子のないメインファイルの名前に置き換えられます。メインファイルとは異なり、セカンダリファイルの名前を入力する必要はありません。

  6. 新しいファイルを追加を使用してセカンダリファイルを追加した場合は、そのファイルの本文を提供します。テンプレートのすべてのファイル内で値を共有する parameters を使用できます。複数のファイルで何らかのパラメーターが使用されており、それを編集可能なままにする場合は、右側のパラメーター領域で編集可能な出現箇所を選択します。この出現箇所は、ユーザーがテンプレートを適用すると、ホットスポットセッションで編集可能になります。セレクタでは、出現箇所には数字の前に文字が付いています。「M」はメインファイル、「S0」、「S1」などを表します。セカンダリファイルを表します。

  7. 既存のテンプレートからファイルを追加するを使用してファイル本体の代わりに新しいファイルを追加すると、既存のテンプレートのパラメーターのリストが表示されます。必要に応じて、これらのパラメーターを現在のテンプレートのパラメーターにマップできます。

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

この機能は、次の言語とテクノロジーでサポートされています。

ここで説明する手順と例では、C# の機能の使用について説明します。他の言語の詳細については、言語別 ReSharper セクションの対応するトピックを参照してください。

関連ページ:

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

コードテンプレートの本体には、次のものが含まれます。ソースコードの構造とコメントを表すプレーンテキスト。テンプレートを適用するとそのまま挿入されます。テンプレートを適用すると動的に置き換えられるテンプレートパラメーター。テンプレートパラメーターの形式は次のとおりです。- ここで、は任意の識別子です。形式が正しい場合、テンプレートエクスプローラーウィンドウは事前定義されたパラメーターを濃い青でハイライトし、その他のパラメーターを濃い赤でハイライトします。定義済みのパラメーター:次のテンプレートパ...

テンプレートの保管

ReSharper のコードテンプレートに関する興味深い点の 1 つは、分散ストレージです。コードテンプレートは、社内組織の詳細を十分に理解していなくても、使用して管理するのに優秀に動作します。ただし、テンプレートの編集や共有に問題が発生したり、複雑な使用シナリオが発生した場合は、これらの詳細を調べる必要があります。定義済みのテンプレート:すべての事前定義テンプレートは ReSharper インストールに保管されています。事前定義されたテンプレートの削除を含むすべての必要な変更は設定レイヤーに...

ファイルテンプレートを作成する

ファイルテンプレートは、型宣言、単体テストなどの事前定義されたコードを含む 1 つ以上の新しいファイルを作成するために使用されます。ファイルテンプレートにはショートカットはなく、説明によって識別されます。詳細については、「テンプレートからファイルを作成するおよびマルチファイルテンプレートを作成する」を参照してください。ファイルテンプレートの本文は、そのまま表示されるプレーンテキストとパラメーターで構成されます。アイデアは、これらを組み合わせてテンプレートを呼び出すときの効率を最大化することです。...

テンプレートエディター

テンプレートエディターは、コードテンプレートの作成と編集に役立ちます。テンプレートエディターが新しいドキュメントタブで開き、テンプレートとアプリケーションコードを切り替えて、作成したテンプレートをすばやくテストできます。テンプレートエディターは、キーワード、コメントなどの基本的なコードのハイライトを提供します。すべてのハイライト色は構成可能です。テンプレートエディターの強調色を構成するメニューからを選択して、ページに移動します。アイテムを表示するリストで、ReSharper テンプレートエディター...

ASP.NET MVC 特有の機能

ReSharper には、一般的な ASP.NET 機能に加えて、ASP.NET MVC での作業をより簡単にサポートする特殊機能があります。構文のハイライト:ASP.NET MVC メソッド呼び出しとパラメーターの特別な構文のハイライト: コード補完:文字列リテラルでアクションとコントローラーを参照するための専用コード補完: ナビゲーションと検索:さまざまなナビゲーション機能がアクションとコントローラーでも機能します。コード生成:使用箇所から新しいコントローラーとアクションを作成する: 最終...

言語による ReSharper: MS ビルド

MSBuild は、アプリケーションを構築するために広く使用されているプラットフォームです。特定の XML タグを使用して、プロジェクトの構築方法や実行方法を定義できます。ReSharper を使用すると、より速く行うことができます。コード検査:あらかじめ定義された要素またはその属性の名前を誤って入力した場合、ReSharper はそのような不一致についてハイライト表示します。まだ定義されていないプロパティを参照しようとすると、ReSharper はそのようなケースも検出します。MSBuild...