Élément ProjectTemplateLink (modèles Visual Studio)

Article
01/13/2024

Spécifie le chemin d’accès au fichier .vstemplate d’un projet dans un modèle multi-projet.

-ou-

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut Description

ProjectName Attribut facultatif.

Spécifie le nom de chaque projet individuel dans un modèle à plusieurs projets. La boîte de dialogue Nouveau projet ne peut pas affecter de noms à des projets individuels.

CopyParameters Permet à toutes les variables du modèle de groupe principal d'être copiées sur chaque modèle lié.

Les paramètres des modèles liés ont un préfixe "$ext_*$". Par exemple, si, dans le modèle de groupe parent, le paramètre $projectname$ a une valeur ExampleProject1, lorsque le modèle lié obtient son tour à exécuter, il acquiert un paramètre $ext_projectname$ , qui est une copie du $projectname$ paramètre à partir du modèle de groupe parent.

Cela permet aux modèles liés de partager des paramètres communs, qui peuvent être aisément créés uniquement dans le modèle de groupe parent.

Cet attribut est facultatif, et il prend automatiquement la valeur false par défaut lorsqu'il n'est pas inclus.

Introduit pour la première fois dans Visual Studio 2013 Update 2. Pour référencer la version correcte du produit, consultez Les assemblys de référence fournis dans visual Studio 2013 SDK Update 2.

Attribut	Description
`ProjectName`	Attribut facultatif. Spécifie le nom de chaque projet individuel dans un modèle à plusieurs projets. La boîte de dialogue Nouveau projet ne peut pas affecter de noms à des projets individuels.
`CopyParameters`	Permet à toutes les variables du modèle de groupe principal d'être copiées sur chaque modèle lié. Les paramètres des modèles liés ont un préfixe `"$ext_$"`. Par exemple, si, dans le modèle de groupe parent, le paramètre $projectname$ a une valeur ExampleProject1*, lorsque le modèle lié obtient son tour à exécuter, il acquiert un paramètre $ext_projectname$ , qui est une copie du $projectname$ paramètre à partir du modèle de groupe parent. Cela permet aux modèles liés de partager des paramètres communs, qui peuvent être aisément créés uniquement dans le modèle de groupe parent. Cet attribut est facultatif, et il prend automatiquement la valeur `false` par défaut lorsqu'il n'est pas inclus. Introduit pour la première fois dans Visual Studio 2013 Update 2. Pour référencer la version correcte du produit, consultez Les assemblys de référence fournis dans visual Studio 2013 SDK Update 2.

Éléments enfants

Aucune.

Éléments parents

Élément	Description
Projectcollection	Spécifie l'organisation et le contenu de modèles à plusieurs projets.
SolutionFolder	Groupe des projets dans des modèles à plusieurs projets.

Valeur texte

Une valeur texte est requise.

Ce texte spécifie le chemin d’accès au fichier .vstemplate du modèle.

Notes

Les modèles à plusieurs projets jouent le rôle de conteneurs pour au moins deux projets. L’élément ProjectTemplateLink est utilisé pour spécifier l’emplacement du fichier .vstemplate pour l’un des projets du modèle. Le fichier .vstemplate d’un modèle multi-projet contient un ProjectTemplateLink élément pour chaque projet du modèle. Pour plus d’informations sur les modèles multi-projets, consultez Guide pratique pour créer des modèles multi-projets.

Exemple

Cet exemple montre un fichier .vstemplate racine multi-projet simple. Dans cet exemple, le modèle contient deux projets, My Windows Application et My Class Library. L’attribut ProjectName de l’élément ProjectTemplateLink définit le nom de Visual Studio pour affecter ce projet. Si l’attribut ProjectName n’existe pas, le nom du fichier .vstemplate est utilisé comme nom de projet.

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

Partager via