ReSharper 2019.3ヘルプ

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

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

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

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

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

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

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

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

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

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

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

  4. セカンダリーファイルを別のフォルダーに追加する場合は、フォルダーフィールドにセカンダリーファイルを指定します。フォルダー階層にはバックスラッシュを使用します。プロジェクトが指定されている場合、新しいフォルダーパスはこのプロジェクトとの相対パスになります。そうでない場合は、メインテンプレートファイルとの相対パスになります。

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

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

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

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

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

Language: C#Language: VB.NETLanguage: C++Language: HTMLLanguage: ASP.NETLanguage: RazorLanguage: JavaScriptLanguage: TypeScriptLanguage: CSSLanguage: XMLLanguage: XAMLLanguage: ResxLanguage: Build ScriptsLanguage: ProtobufLanguage: JSON
Feature is availableFeature is availableFeature is availableFeature is availableFeature is availableFeature is availableFeature is not availableFeature is not availableFeature is not availableFeature is not availableFeature is availableFeature is not availableFeature is not availableFeature is not availableFeature is not available

C#の機能の使用方法については、こちらの説明と例を参照してください。他言語の詳細については、言語によるReSharperの対応するトピックを参照してください。

最終更新日: 2019年12月12日

関連ページ:

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

コードテンプレートの本体には、次のものが含まれます。ソースコードの構造とコメントを表すプレーンテキスト。テンプレートを適用するとそのまま挿入されます。テンプレートを適用すると動的に置き換えられるテンプレートパラメータ。テンプレートパラメータの形式は次のとおりです。-は任意の識別子です。フォーマットが...

ホットスポットセッション

ReSharperの多くの機能は、エディターでコードのブロックを挿入または置換します。このブロックを完了するためにユーザー入力が必要な場合、これらの機能は多くの場合インタラクティブに機能するため、ReSharperはコードブロックの挿入直後に利用可能なすべての提案と変更をガイドします。これが発生する...

テンプレートの保存

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

ファイルテンプレートの作成

ファイル・テンプレートは、型宣言、単体テストなどの定義済みコードで1つ以上の新しいファイルを作成するために使用されます。ファイルテンプレートにはショートカットはなく、説明によって識別されます。詳細については、テンプレートからのファイルの作成\および複数ファイルテンプレートの作成を参照してください。新...

テンプレートの編集

テンプレートエクスプローラーウィンドウで見つけることができるすべてのテンプレートはあなたのニーズと開発習慣に従って編集することができます。テンプレートの本文を編集したり、ライブテンプレートのショートカットやすべてのテンプレートの説明を変更したり、テンプレート範囲を変更したり、テンプレートパラメータを...

テンプレート・エディター

テンプレート・エディターはコードテンプレートの作成と編集を手助けします。テンプレートエディターが新しいドキュメントタブに表示されるため、テンプレートとアプリケーションコードを切り替えて、作成したテンプレートをすばやくテストできます。テンプレートエディターは、キーワード、コメントなどの基本的なコードの...