Comment : localiser et organiser les modèles de projet et d'élément

Article
06/10/2015

Les fichiers modèles doivent être placés dans un emplacement que Visual Studio reconnaît afin que les modèles s'affichent dans les boîtes de dialogue Nouveau projet et Ajouter un nouvel élément.Vous pouvez créer des sous-catégories personnalisées de modèles afin qu'elles apparaissent également dans l'interface utilisateur.

Localisation de modèles

Par défaut, Visual Studio effectue la recherche de modèles de projets et d'éléments dans deux emplacements.Si un fichier compressé incluant un fichier .vstemplate existe à ces emplacements, un modèle apparaît dans la boîte de dialogue Nouveau projet ou Ajouter un nouvel élément.

Modèles installés

Par défaut, les modèles installés avec le produit se trouvent dans :

\VisualStudioInstallationDirectory\ Common7\IDE\ItemTemplates \Language\Locale\
\VisualStudioInstallationDirectory\ Common7\IDE\ProjectTemplates \Language\Locale\

Par exemple, le répertoire suivant contient des modèles de projet Visual Studio pour l'anglais :

C:\VisualStudioInstallationDirectory\ Common7\IDE\ItemTemplates\Visual Basic\1033 \

Modèles personnalisés

Par défaut, les modèles personnalisés se trouvent dans :

\Mes documents\Visual Studio Version\Templates\ProjectTemplates\Language\
\Mes documents\Visual Studio Version\Templates\ItemTemplates\Language\

Par exemple, le répertoire suivant contient des modèles de projet Visual C# personnalisés :

C:\Documents and Settings\NomUtilisateur\Mes documents\Visual Studio 2013\Templates\ProjectTemplates\Visual C#\

Les modèles personnalisés n'incluent pas de sous-répertoire pour les modèles localisés.Vous pouvez modifier le répertoire par défaut des modèles personnalisés dans la boîte de dialogue Options de Environnement\Projets et solutions.

Organisation de modèles

Les catégories des boîtes de dialogue Nouveau projet et Ajouter un nouvel élément reflètent les structures de répertoires qui existent pour les modèles installés et personnalisés.Vous pouvez modifier ces structures de répertoires pour organiser vos modèles selon votre propre logique.

[!REMARQUE]

Vous ne pouvez pas créer de nouvelle catégorie au niveau du langage de programmation.Vous ne pouvez créer une catégorie qu'à l'intérieur de chaque langage.

Si les répertoires des modèles installés et personnalisés pour un langage particulier n'ont pas la même structure (c'est-à-dire un dossier contient des répertoires qui n'existent pas dans l'autre dossier), le jeu de catégories qui apparaît dans la boîte de dialogue Nouveau projet est la fusion de toutes les catégories.

Organisation de modèles installés

Vous pouvez organiser les modèles installés en créant des sous-répertoires dans le dossier du langage de programmation.Ces sous-répertoires apparaissent dans les boîtes de dialogue Nouveau projet et Ajouter un nouvel élément en tant que dossiers virtuels dans chaque langage.

Pour créer des catégories de modèles de projet installés

Créez un dossier dans le dossier du langage, dans le répertoire des modèles installés.Par exemple, pour créer une catégorie Office pour les modèles de projet Visual Studio vous pourriez créer le répertoire suivant :

\VisualStudioInstallationDirectory\Common7\IDE\ProjectTemplates\VisualBasic\1033\Office\
Placez tous les modèles de cette catégorie dans le nouveau dossier.
Fermez toutes les instances de Visual Studio.
Dans le menu Démarrer, cliquez sur Exécuter, tapez cmd puis cliquez sur OK.
À l'invite de commandes, situez le répertoire qui contient devenv.exe et tapez devenv /installvstemplates.
Exécutez Visual Studio.
Dans le menu Fichier, cliquez sur Nouveau, puis sur Projet.
Vérifiez que la catégorie Office apparaît dans la boîte de dialogue Nouveau projet, dans le volet Types de projets de Visual Basic.

Vous pouvez également grouper dans un dossier personnalisé un sous-ensemble de modèles d'éléments de projet.

Pour créer des catégories de modèles d'éléments installés

Créez un dossier dans le dossier du langage, dans le répertoire des modèles installés.Par exemple, pour créer une catégorie Web de modèles d'éléments Visual C#, vous pourriez créer le répertoire suivant :

\VisualStudioInstallationDirectory\ Common7\IDE\ItemTemplates\CSharp\1033\Web \
Placez tous les modèles de cette catégorie dans le nouveau dossier.
Fermez toutes les instances de Visual Studio.
Dans le menu Démarrer, cliquez sur Exécuter, tapez cmd puis cliquez sur OK.
À l'invite de commandes, situez le répertoire qui contient devenv.exe et tapez devenv /setup.
Exécutez Visual Studio.
Créez un nouveau projet ou ouvrez un projet existant.
Dans le menu Projet, cliquez sur Ajouter un nouvel élément.
Vérifiez que la catégorie Web apparaît dans la boîte de dialogue Ajouter un nouvel élément, dans le volet Types de projets.

Organisation de modèles personnalisés

Pour organiser des modèles personnalisés dans leurs propres catégories, ajoutez de nouveaux dossiers à leur emplacement.La boîte de dialogue Nouveau projet reflète toutes les modifications que vous apportez à vos catégories de modèles.

Pour créer des catégories de modèles personnalisés

Créez un dossier dans le dossier du langage, dans le répertoire des modèles de projets personnalisés.Par exemple, pour créer une catégorie HelloWorld de modèles Visual C#, vous pourriez créer le répertoire suivant :

\My Documents\Visual Studio 2013\Templates\ProjectTemplates\CSharp\HelloWorld\
Placez tous les modèles de cette catégorie dans le nouveau dossier.
Dans le menu Fichier, cliquez sur Nouveau, puis sur Projet.
Vérifiez que la catégorie HelloWorld apparaît dans la boîte de dialogue Nouveau projet, dans le volet Types de projets, sous Visual C#.

Vous pouvez également grouper dans un dossier personnalisé un sous-ensemble de modèles d'éléments personnalisés.

Pour créer des catégories de modèles d'éléments personnalisés

Créez un dossier dans le dossier du langage, dans le répertoire des modèles d'éléments personnalisés.Par exemple, pour créer une catégorie HelloWorld de modèles Visual C#, vous pourriez créer le répertoire suivant :

\My Documents\Visual Studio 2013\Templates\ItemTemplates\CSharp\HelloWorld\
Placez tous les modèles de cette catégorie dans le nouveau dossier.
Créez un nouveau projet ou ouvrez un projet existant.
Dans le menu Projet, cliquez sur Ajouter un nouvel élément.
Vérifiez que la catégorie HelloWorld apparaît dans la boîte de dialogue Ajouter un nouvel élément, dans le volet Types de projets.

Affichage de modèles dans des catégories parentes

Vous pouvez permettre aux modèles des sous-catégories d'être affichés dans leur catégorie parente à l'aide de l'élément NumberOfParentCategoriesToRollUp du fichier .vstemplate.Ces étapes sont identiques pour les modèles de projet et les modèles d'élément.

Pour afficher des modèles dans les catégories parentes

Localisez le fichier .zip qui contient le modèle.
Extrayez le fichier .zip.
Ouvrez le fichier .vstemplate dans Visual Studio.
Dans l'élément TemplateData, ajoutez un élément NumberOfParentCategoriesToRollUp.Par exemple, le code suivant fait apparaître le modèle dans sa catégorie parente, mais pas plus haut dans la hiérarchie :
```
<TemplateData>
    ...
    <NumberOfParentCategoriesToRollUp>
        1
    </NumberOfParentCategoriesToRollUp>
    ...
</TemplateData>
```
Enregistrez et fermez le fichier .vstemplate.
Sélectionnez les fichiers présents dans votre modèle, cliquez avec le bouton droit sur la sélection, cliquez sur Envoyer vers puis sur Dossier compressé (zippé).Les fichiers sont compressés dans un fichier .zip.
Supprimez les fichiers de modèles extraits et l'ancien fichier .zip du modèle.
Mettez le nouveau fichier .zip dans le répertoire duquel vous avez supprimé le fichier .zip.

Voir aussi