如何:创建多文件项模板
更新:2007 年 11 月
项模板只能指定一个项,但有时一个项也包含多个文件。例如,Windows 窗体项模板需要以下三个文件:
一个 .vb 文件,包含该窗体的代码。
一个 .designer.vb 文件,包含该窗体的设计器信息。
一个 .resx 文件,包含该窗体的嵌入资源。
多文件项模板需要使用参数来确保在 Visual Studio 中创建项时使用正确的文件扩展名。如果您使用“导出模板”向导创建项模板,则将自动生成这些参数,不需要进一步进行编辑。以下过程说明如何使用参数确保创建正确的文件扩展名。
手动创建多文件项模板
采用与创建单文件项模板相同的方式创建该项模板。有关更多信息,请参见 如何:手动创建项模板。
向每个 ProjectItem 元素中添加 TargetFileName 属性。将 TargetFileName 属性的值设置为 $fileinputname$.文件扩展名,其中 文件扩展名 是该模板中所包含的文件的文件扩展名。例如:
<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 2008\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>