Comment : créer des modèles à plusieurs projets

Article
08/21/2008

Mise à jour : novembre 2007

Les modèles à plusieurs projets jouent le rôle de conteneurs pour au moins deux projets. Lorsqu'un projet basé sur un modèle à plusieurs projets est créé à partir de la boîte de dialogue Nouveau projet, tous les projets inclus dans le modèle s'ajoutent à la solution.

Un modèle à plusieurs projets doit inclure les éléments suivants, compressés dans un seul et même fichier .zip :

Un fichier .vstemplate racine pour tout le modèle à plusieurs projets. Ce fichier .vstemplate racine contient les métadonnées affichées dans la boîte de dialogue Nouveau projet et spécifie où rechercher les fichiers .vstemplate pour les projets de ce modèle. Ce fichier doit se trouver à la racine du fichier .zip.
Un ou plusieurs dossiers contenant les fichiers nécessaires à un modèle de projet complet. Ils incluent tous les fichiers de code du projet ainsi qu'un fichier .vstemplate pour le projet.

Par exemple, le fichier .zip d'un modèle pour deux projets pourrait contenir les fichiers et répertoires suivants :

MultiProjectTemplate.vstemplate

\Project1\Project1.vstemplate

\Project1\Project1.vbproj

\Project1\Class.vb

\Project2\Project2.vstemplate

\Project2\Project2.vbproj

\Project2\Class.vb

Le fichier .vstemplate racine d'un modèle à plusieurs projets présente les différences suivantes par rapport à un modèle de projet unique :

L'attribut Type de l'élément VSTemplate contient la valeur ProjectGroup. Par exemple :

<VSTemplate Version="2.0.0" Type="ProjectGroup"
    xmlns="https://schemas.microsoft.com/developer/vstemplate/2005">

L'élément TemplateContent contient un élément ProjectCollection avec un ou plusieurs éléments ProjectTemplateLink qui définissent les chemins d'accès aux fichiers .vstemplate des projets inclus. Par exemple :

<TemplateContent>
    <ProjectCollection>
        <ProjectTemplateLink>
            Project1\Project1.vstemplate
        </ProjectTemplateLink>
        <ProjectTemplateLink>
            Project2\Project2.vstemplate
        </ProjectTemplateLink>
    </ProjectCollection>
</TemplateContent>

Les modèles à plusieurs projets ont également un comportement différent des modèles normaux. Les modèles à plusieurs projets ont les caractéristiques uniques suivantes :

Il n'est pas possible d'assigner des noms à des projets individuels d'un modèle à plusieurs projets dans la boîte de dialogue Nouveau projet. À la place, pour spécifier le nom de chaque projet, utilisez l'attribut ProjectName sur l'élément ProjectTemplateLink. Pour plus d'informations, consultez le premier exemple de la section suivante.
Les modèles à plusieurs projets peuvent contenir des projets écrits dans différents langages, mais le modèle entier lui-même ne peut être placé que dans une catégorie avec l'élément ProjectType.

Pour créer un modèle à plusieurs projets

Créez les projets à inclure dans le modèle à plusieurs projets.
Créez des fichiers .vstemplate pour chacun des projets. Pour plus d'informations, consultez Comment : créer des modèles de projet et Comment : créer manuellement des modèles de projet.
Créez un fichier .vstemplate racine qui contiendra les métadonnées du modèle à plusieurs projets. Pour plus d'informations, consultez le premier exemple de la section suivante.
Sélectionnez les fichiers et dossiers à inclure dans votre modèle, cliquez avec le bouton droit, sélectionnez Envoyer vers et cliquez sur Dossier compressé (dossier zippé). Les fichiers et dossiers sont compressés dans un fichier .zip.
Placez le fichier modèle .zip dans le répertoire du modèle de projet Visual Studio. Par défaut, ce répertoire est Mes documents\Visual Studio 2008\Templates\ProjectTemplates.

Exemple

Cet exemple affiche un fichier .vstemplate racine simple pour un modèle à plusieurs projets. 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 à assigner au projet dans Visual Studio. Si l'attribut ProjectName n'existe pas, le nom du fichier .vstemplate est utilisé comme nom du projet.

<VSTemplate Version="2.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">
                ClassLib\MyTemplate.vstemplate
            </ProjectTemplateLink>
        </ProjectCollection>
    </TemplateContent>
</VSTemplate>

Cet exemple utilise l'élément SolutionFolder pour diviser les projets en deux groupes, Math Classes et Graphics Classes. Le modèle contient quatre projets, dont deux placés dans chaque dossier de solution.

<VSTemplate Version="2.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>
            <SolutionFolder Name="Math Classes">
                <ProjectTemplateLink ProjectName="MathClassLib1">
                    MathClassLib1\MyTemplate.vstemplate
                </ProjectTemplateLink>
                <ProjectTemplateLink ProjectName="MathClassLib2">
                    MathClassLib2\MyTemplate.vstemplate
                </ProjectTemplateLink>
            </SolutionFolder>
            <SolutionFolder Name="Graphics Classes">
                <ProjectTemplateLink ProjectName="GraphicsClassLib1">
                    GraphicsClassLib1\MyTemplate.vstemplate
                </ProjectTemplateLink>
                <ProjectTemplateLink ProjectName="GraphicsClassLib2">
                    GraphicsClassLib2\MyTemplate.vstemplate
                </ProjectTemplateLink>
            </SolutionFolder>
        </ProjectCollection>
    </TemplateContent>
</VSTemplate>

Voir aussi

Partager via

Comment : créer des modèles à plusieurs projets

Pour créer un modèle à plusieurs projets

Exemple

Voir aussi

Tâches

Référence

Autres ressources

Ressources supplémentaires