Elemento ProjectTemplateLink (modelos do Visual Studio)

Artigo
05/15/2024

Especifica o caminho para o arquivo .vstemplate de um projeto em um modelo de vários projetos.

<VSTemplate><TemplateContent<>ProjectCollection><ProjectTemplateLink>

-ou-

<VSTemplate TemplateContent<>ProjectCollection<>SolutionFolder><ProjectTemplateLink><>

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição

ProjectName Atributo opcional.

Especifica o nome de cada projeto individual em um modelo de vários projetos. A caixa de diálogo Novo Projeto não pode atribuir nomes a projetos individuais.

CopyParameters Permite que todas as variáveis no modelo de grupo principal sejam copiadas em cada um dos modelos vinculados.

Os parâmetros nos modelos vinculados têm um prefixo "$ext_*$". Por exemplo, se no modelo de grupo pai o parâmetro $projectname$ tiver um valor ExampleProject1, quando o modelo vinculado tiver sua vez de ser executado, ele adquirirá um parâmetro $ext_projectname$ , que é uma cópia do parâmetro do modelo de $projectname$ grupo pai.

Isso permite que modelos vinculados compartilhem alguns parâmetros comuns, que podem ser convenientemente criados somente no modelo de grupo pai.

Esse atributo é opcional e padronizado automaticamente para false quando não é incluído.

Introduzido no Visual Studio 2013 Atualização 2. Para fazer referência à versão correta do produto, consulte Assemblies de referência entregues na Atualização 2 do SDK do Visual Studio 2013.

Atributo	Descrição
`ProjectName`	Atributo opcional. Especifica o nome de cada projeto individual em um modelo de vários projetos. A caixa de diálogo Novo Projeto não pode atribuir nomes a projetos individuais.
`CopyParameters`	Permite que todas as variáveis no modelo de grupo principal sejam copiadas em cada um dos modelos vinculados. Os parâmetros nos modelos vinculados têm um prefixo `"$ext_$"`. Por exemplo, se no modelo de grupo pai o parâmetro $projectname$ tiver um valor ExampleProject1*, quando o modelo vinculado tiver sua vez de ser executado, ele adquirirá um parâmetro $ext_projectname$ , que é uma cópia do parâmetro do modelo de $projectname$ grupo pai. Isso permite que modelos vinculados compartilhem alguns parâmetros comuns, que podem ser convenientemente criados somente no modelo de grupo pai. Esse atributo é opcional e padronizado automaticamente para `false` quando não é incluído. Introduzido no Visual Studio 2013 Atualização 2. Para fazer referência à versão correta do produto, consulte Assemblies de referência entregues na Atualização 2 do SDK do Visual Studio 2013.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
ProjectCollection	Especifica a organização e o conteúdo de modelos de vários projetos.
SolutionFolder	Agrupa projetos em modelos de vários projetos.

Valor do texto

Um valor de texto é obrigatório.

Este texto especifica o caminho para o arquivo .vstemplate do modelo.

Comentários

Os modelos de vários projetos atuam como contêineres para dois ou mais projetos. O ProjectTemplateLink elemento é usado para especificar o local do arquivo .vstemplate para um dos projetos no modelo. O arquivo .vstemplate de um modelo de vários projetos contém um ProjectTemplateLink elemento para cada projeto no modelo. Para obter mais informações sobre modelos de vários projetos, consulte Como: Criar modelos de vários projetos.

Exemplo

Este exemplo mostra um arquivo .vstemplate raiz de vários projetos simples. Neste exemplo, o modelo contém dois projetos, My Windows Application e My Class Library. O ProjectName atributo no ProjectTemplateLink elemento define o nome do Visual Studio para atribuir este projeto. Se o ProjectName atributo não existir, o nome do arquivo .vstemplate será usado como o nome do projeto.

<VSTemplate Version="3.0.0" Type="ProjectGroup"
    xmlns="http://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>

Partilhar via