如何:创建多文件项模板
项模板只能指定一个项,但有时一个项也包含多个文件。 例如,Windows 窗体项模板需要以下三个文件:
一个 .vb 文件,包含该窗体的代码。
一个 .designer.vb 文件,包含该窗体的设计器信息。
一个 .resx 文件,包含该窗体的嵌入资源。
多文件项模板需要使用参数来确保在 Visual Studio 中创建项时使用正确的文件扩展名。 如果您使用**“导出模板”**向导创建项模板,则将自动生成这些参数,且无需进一步编辑。 下列步骤说明如何使用参数来确保创建正确的文件扩展名。
手动创建多文件项模板
采用与创建单文件项模板相同的方式创建多文件项模板。 有关更多信息,请参见如何:手动创建项模板。
将 TargetFileName 特性添加到每个 ProjectItem 元素。 将 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>
当向项目中添加从此模板派生的项时,将基于用户在**“添加新项”**对话框中键入的名称来指定文件名。
选择要包含在模板中的文件,右击选定内容,单击**“发送到”,然后单击“压缩(zipped)文件夹”**。 所选的文件被压缩为一个 .zip 文件。
将该 .zip 文件置于用户项模板位置。 默认情况下,该目录为 \My Documents\Visual Studio 2010\Templates\ItemTemplates\。 有关更多信息,请参见如何:查找和组织项目模板和项模板。
示例
下面的示例演示一个 Visual Studio Windows 窗体模板。 基于此模板创建项时,创建的三个文件的名称将与**“添加新项”**对话框中输入的名称匹配。
<VSTemplate Version="2.0.0" Type="Item"
xmlns="https://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>