ProjectTemplateLink 元素(Visual Studio 模板)

指定多项目模板中一个项目的 .vstemplate 文件的路径。

<ProjectTemplateLink ProjectName="Name">
    PathToTemplateFile
</ProjectTemplateLink>

特性和元素

以下各部分描述了特性、子元素和父元素。

特性

特性

描述

ProjectName

可选特性。

指定多项目模板中每一个项目的名称。 “新建项目”对话框不能向单个项目分配名称。

CopyParameters

使主要组模板中的所有变量可复制到每个链接模板。

链接模板中的参数具有前缀 "$ext_*$"。 例如,如果在父组模板中,参数 $projectname$ 具有值 ExampleProject1,则轮到链接模板执行时,它将获取参数 $ext_projectname$,此参数为父组模板中 $projectname$ 参数的副本。

这使链接模板能够共享一些只能在父组模板中方便地创建的公用参数。

此特性为可选特性,未包含此特性时,它将自动默认为 false。

在 Visual Studio 2013 Update 2 中引入。 若要引用正确的产品版本,请参阅Referencing Assemblies Delivered in the Visual Studio 2013 SDK Update 2

子元素

无。

父元素

元素

描述

ProjectCollection

指定多项目模板的组织和内容。

SolutionFolder

对多项目模板中的项目进行分组。

文本值

需要一个文本值。

此文本指定模板的 .vstemplate 文件的路径。

备注

多项目模板用作两个或多个项目的容器。 ProjectTemplateLink 元素用于指定模板中一个项目的 .vstemplate 文件的位置。 对于多项目模板中的每个项目,此模板的 .vstemplate 文件中都含有一个对应的 ProjectTemplateLink 元素。 有关多项目模板的详细信息,请参阅如何:创建多项目模板

示例

此示例演示一个简单的多项目 .vstemplate 根文件。 在此示例中,模板包含两个项目:My Windows Application 和 My Class Library。 ProjectTemplateLink 元素的 ProjectName 特性可为 Visual Studio 设置要分配给此项目的名称。 如果不存在 ProjectName 特性,则会使用 .vstemplate 文件的名称作为项目名称。

<VSTemplate Version="3.0.0" Type="ProjectGroup"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>Multi-Project Template Sample</Name>
        <Description>An example of a multi-project template</Description>
        <Icon>Icon.ico</Icon>
        <ProjectType>VisualBasic</ProjectType>
    </TemplateData>
    <TemplateContent>
        <ProjectCollection>
            <ProjectTemplateLink ProjectName="My Windows Application">
                WindowsApp\MyTemplate.vstemplate
            </ProjectTemplateLink>
            <ProjectTemplateLink ProjectName="My Class Library" CopyParameters="true">
                ClassLib\MyTemplate.vstemplate
            </ProjectTemplateLink>
        </ProjectCollection>
    </TemplateContent>
</VSTemplate>

请参见

任务

如何:创建多项目模板

参考

Visual Studio 模板架构参考

概念

在 Visual Studio 中创建项目和项的模板