如何:创建多文件项模板

项模板只能指定一个项,但有时一个项也包含多个文件。 例如,Windows 窗体项模板需要以下三个文件:

  • 一个 .vb 文件,包含该窗体的代码。

  • 一个 .designer.vb 文件,包含该窗体的设计器信息。

  • 一个 .resx 文件,包含该窗体的嵌入资源。

多文件项模板需要使用参数来确保在 Visual Studio 中创建项时使用正确的文件扩展名。 如果您使用**“导出模板”**向导创建项模板,则将自动生成这些参数,且无需进一步编辑。 下列步骤说明如何使用参数来确保创建正确的文件扩展名。

手动创建多文件项模板

  1. 采用与创建单文件项模板相同的方式创建多文件项模板。 有关更多信息,请参见如何:手动创建项模板

  2. 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>
    

    当向项目中添加从此模板派生的项时,将基于用户在**“添加新项”**对话框中键入的名称来指定文件名。

  3. 选择要包含在模板中的文件,右击选定内容,单击**“发送到”,然后单击“压缩(zipped)文件夹”**。 所选的文件被压缩为一个 .zip 文件。

  4. 将该 .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>

请参见

任务

如何:创建项模板

如何:手动创建项模板

如何:替换模板中的参数

概念

模板参数

其他资源

创建项模板