マルチファイルテンプレートを作成する
ファイルテンプレートは、テンプレートを適用するときに複数のファイルを作成できます。 これは、関連するデータが別のファイルに保存されている場合に役立ちます。
マルチファイルテンプレートについて知っておくべきことがいくつかあります:
ファイルテンプレートには常に 1 つのメインファイルと、オプションで任意の数のセカンダリファイルが含まれます。 任意のファイルテンプレートにセカンダリファイルを追加すると、すぐに複数のファイルテンプレートが作成されます。
セカンダリファイルを追加するときは、既存のファイルテンプレートを参照できます(既存のテンプレートからファイルを追加する オプション)。 参照されるテンプレートにも複数のファイルがある場合は、テンプレートを適用するときに、参照されるテンプレートのメインファイルだけが追加されることに注意してください。
パラメーターのセットは、マルチファイルテンプレートのすべてのファイルにおよびます。 つまり、マルチファイルテンプレートの複数のファイルで同じパラメーター
$PARAM$を使用する場合、テンプレートが適用されると、関連するすべてのファイルで同じ値になります。複数ファイルテンプレートに 編集可能なパラメーターがある場合、このテンプレートを適用するとデプロイされる ホットスポットセッション が、ユーザー入力が必要なすべての作成されたファイルで案内します。
ファイルテンプレートに新しいファイルを追加する
テンプレートエディター の下部で、 新しいファイルを追加 または 既存のテンプレートからファイルを追加する をクリックします。 新しいセクションがメインファイルの本体に追加されます。
デフォルトでは、新しいセカンダリファイルがメインファイルと同じプロジェクトに追加されます。 異なるプロジェクトに追加する場合は、このプロジェクトの名前を プロジェクト フィールドに指定します。 指定したプロジェクトが、テンプレートが適用されているソリューションに存在しない場合、セカンダリファイルは追加されません。
セカンダリファイルを別のフォルダーに追加する場合は、 フォルダー フィールドで指定します。 フォルダー階層には円記号を使用します。 いくつかのプロジェクトが指定されている場合、新しいフォルダーパスはこのプロジェクトを基準にしており、そうでない場合はメインテンプレートファイルを基準としていることに注意してください。
セカンダリファイルの名前を指定します。
$NAME$は拡張子のないメインファイルの名前に置き換えられます。 メインファイルとは異なり、セカンダリファイルの名前を入力する必要はありません。新しいファイルを追加 でセカンダリファイルを追加した場合は、その本文を入力してください。 テンプレート内のすべてのファイルで値を共有する パラメーターを使用できます。 パラメーターが複数のファイルで使用され、それを 編集可能にしたい場合、右側の パラメーター エリアで編集可能な箇所を選択してください。この箇所はテンプレート適用時の ホットスポットセッション で編集できます。 セレクター内では、該当箇所に英字を先頭に付けた番号が表示されます。'M'はメインファイル、'S0'や'S1'などはセカンダリファイルを表します。 セカンダリファイルを表します。
既存のテンプレートからファイルを追加する を使用してファイル本体の代わりに新しいファイルを追加すると、既存のテンプレートのパラメーターのリストが表示されます。 必要に応じて、これらのパラメーターを現在のテンプレートのパラメーターにマップできます。
テンプレートを保存するには、Visual Studio メニューで を選ぶか、 Ctrl+S を押してください。
この機能は、次の言語とテクノロジーで サポートされています。
ここで説明する手順と例では、C# の機能の使用について説明します。 他の言語の詳細については、 言語およびフレームワーク セクションの対応するトピックを参照してください。