複数ファイルの項目テンプレートを作成する

項目テンプレートには 1 つの項目のみを指定できますが、1 つの項目が複数のファイルから構成されている場合があります。 たとえば、Windows フォーム項目テンプレートには、次の 3 つのファイルが必要です。

• フォームのコードを含むファイル

• フォームのデザイナー情報を含むファイル

• フォームの埋め込みリソースを含むファイル

複数ファイルの項目テンプレートでは、項目が作成されるときに正しいファイル拡張子が使われるようにするため、パラメーターが必要です。 テンプレートのエクスポート ウィザードを使って複数ファイルの項目テンプレートを作成する場合、これらのパラメーターは自動的に生成されるので、それ以上編集する必要はありません。

[テンプレートのエクスポート] ウィザードを使用する

複数ファイルの項目テンプレートは、単一ファイルの項目テンプレートと同じ方法で作成できます。 「方法: 項目テンプレートを作成する」を参照してください。 ウィザードの [エクスポートする項目の選択] ページで、依存ファイル (Windows フォームのフォーム ファイルなど) を持つファイルを選択します。 依存ファイル (デザイナー ファイルやリソース ファイルなど) が、ウィザードによってテンプレートに自動的に追加されます。

複数ファイルの項目テンプレートを手動で作成する

1. 手動で単一ファイルの項目テンプレートを作成するのと同じように項目テンプレートを作成しますが、複数ファイルの項目を構成する各ファイルを組み込みます。

2. .vstemplate XML ファイルで、各個別ファイルに対する ProjectItem 要素を追加し、この要素に TargetFileName 属性を追加します。 TargetFileName 属性の値を $fileinputname$.FileExtension に設定します。ここで、FileExtension はテンプレートに含まれるファイルのファイル拡張子です。 次に例を示します。

   <ProjectItem TargetFileName="$fileinputname$.vb">
       Form1.vb
   </ProjectItem>
   <ProjectItem TargetFileName="$fileinputname$.Designer.vb">
       Form1.Designer.vb
   </ProjectItem>
   <ProjectItem TargetFileName="$fileinputname$.resx">
       Form1.resx
   </ProjectItem>
   

   Note

   このテンプレートから派生した項目がプロジェクトに追加されると、ユーザーが [新しい項目の追加] ダイアログ ボックスで入力した名前からファイル名が派生されます。

3. テンプレートに組み込むファイルを選んで右クリックし、[送る]>[圧縮 (zip 形式) フォルダー] の順に選択します。

   選択したファイルは .zip ファイルに圧縮されます。

4. ユーザー項目テンプレートの場所に .zip ファイルをコピーします。 既定のディレクトリは、%USERPROFILE%\Documents\Visual Studio <バージョン>\Templates\ItemTemplates です。 詳細については、「方法: プロジェクト テンプレートと項目テンプレートを配置して整理する」を参照してください。

5. Visual Studio をいったん閉じて開きなおします。

6. 新しいプロジェクトを作成するか、既存のプロジェクトを開き、[プロジェクト]>[新しい項目の追加] の順に選ぶか、Ctrl+Shift+A キーを押します。

   複数ファイルの項目テンプレートが、[新しい項目の追加] ダイアログ ボックスに表示されます。

例

次の例では、Windows フォーム テンプレートを示します。 このテンプレートに基づいて項目が作成された場合、作成された 3 つのファイルの名前は [新しい項目の追加] ダイアログ ボックスに入力された名前と一致します。

<VSTemplate Version="2.0.0" Type="Item"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>Multi-file Item Template</Name>
        <Icon>Icon.ico</Icon>
        <Description>An example of a multi-file item template</Description>
        <ProjectType>VisualBasic</ProjectType>
    </TemplateData>
    <TemplateContent>
        <ProjectItem TargetFileName="$fileinputname$.vb" SubType="Form">
            Form1.vb
        </ProjectItem>
        <ProjectItem TargetFileName="$fileinputname$.Designer.vb">
            Form1.Designer.vb
        </ProjectItem>
        <ProjectItem TargetFileName="$fileinputname$.resx">
            Form1.resx
        </ProjectItem>
    </TemplateContent>
</VSTemplate>

関連するコンテンツ

• プロジェクト テンプレートと項目テンプレートを作成する
• 方法: 項目テンプレートを作成する
• テンプレート パラメーター
• 方法 : テンプレート内のパラメーターを置き換える