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

Article
08/21/2008

Mise à jour : novembre 2007

Les fichiers modèles doivent se trouver à un emplacement reconnu par Visual Studio pour que les modèles apparaissent 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 dans l'interface utilisateur.

Localisation de modèles

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

Modèles installés

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

<RépertoireInstallVisualStudio>\Common7\IDE\ItemTemplates\Langage\ParamètresRégionaux\
<RépertoireInstallVisualStudio>\Common7\IDE\ProjectTemplates\Langage\ParamètresRégionaux\

Par exemple, le répertoire suivant contient tous les modèles de projet Visual Studio en Anglais :

C:\Program Files\Microsoft Visual Studio 9,0\Common7\IDE\ItemTemplates\VisualBasic\1033\

Modèles personnalisés

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

Mes documents\Visual Studio 2008\Templates\ProjectTemplates\Langage\
Mes documents\Visual Studio 2008\Templates\ItemTemplates\Langage\

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 2008\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. Pour plus d'informations, consultez Général, Projets et solutions, boîte de dialogue Options.

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 des modèles installés en créant des sous-répertoires dans le dossier du langage de programmation. Ces sous-répertoires apparaissent en tant que dossiers virtuels dans les boîtes de dialogue Nouveau projet et Ajouter un nouvel élément 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 :

<RépertoireInstallVisualStudio>\Common7\IDE\ProjectTemplates\VisualBasic\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" et cliquez sur OK.
À l'invite de commandes, naviguez jusqu'au répertoire qui contient devenv.exe et tapez "devenv /installation".
Exécutez Visual Studio.
Dans le menu Fichier, cliquez sur Nouveau, puis sur Projet.
Vérifiez que la catégorie Office apparaît sous Visual Basic dans le volet Types de projets de la boîte de dialogue Nouveau projet.

De la même façon, vous pouvez 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 :

<RépertoireInstallVisualStudio>\Common7\IDE\ItemTemplates\CSharp\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" et cliquez sur OK.
À l'invite de commandes, naviguez jusqu'au répertoire qui contient devenv.exe et tapez "devenv /installation".
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 le volet Types de projets de la boîte de dialogue Ajouter un nouvel élément.

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 :

Mes documents\Visual Studio 2008\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 sous Visual C# dans le volet Types de projets de la boîte de dialogue Nouveau projet.

De la même façon, vous pouvez 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 :

Mes documents\Visual Studio 2008\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 le volet Types de projets de la boîte de dialogue Ajouter un nouvel élément.

Affichage de modèles dans des catégories parentes

Vous pouvez autoriser l'affichage de modèles dans des sous-catégories de leurs catégories parentes en utilisant l'élément NumberOfParentCategoriesToRollUp du fichier .vstemplate. Cette procédure est identique que les modèles concernent les projets ou les éléments.

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 la catégorie parente, mais pas plus haut :
```
<TemplateData>
    ...
    <NumberOfParentCategoriesToRollUp>
        1
    </NumberOfParentCategoriesToRollUp>
    ...
</TemplateData>
```
Enregistrez et fermez le fichier .vstemplate.
Sélectionnez les fichiers inclus dans votre modèle, cliquez avec le bouton droit, sélectionnez Envoyer vers et cliquez sur Dossier compressé (dossier zippé). Les fichiers que vous avez sélectionnés sont compressés dans un fichier .zip.
Supprimez les fichiers de modèles extraits et l'ancien fichier .zip du modèle.
Placez le nouveau fichier .zip dans le même répertoire que le fichier .zip supprimé.