Partager via

Créer des modèles d’élément

Cet article vous montre comment créer un modèle d’élément à l’aide de l’Assistant Exportation de modèle ou manuellement, et comment modifier et utiliser des modèles d’élément. Si votre modèle se compose de plusieurs fichiers, consultez également Comment : créer des modèles d’élément à plusieurs fichiers.

Ajouter un modèle d’article

  1. Créez ou ouvrez un projet dans Visual Studio.

  2. Sélectionnez Projet>Ajouter un nouvel élément ou appuyez sur Ctrl+Maj+A.

  3. Dans la boîte de dialogue Ajouter un nouvel élément , sélectionnez un élément, puis sélectionnez Ajouter pour l’ajouter au projet.

  4. Modifiez l’élément comme vous le souhaitez et indiquez où le remplacement des paramètres doit avoir lieu dans l’élément, le cas échéant. Pour plus d’informations, consultez How to : Substitute parameters in a template.

  5. Enregistrez l’élément.

  6. SélectionnezModèle d’exportation deprojet>. L’Assistant Exportation de modèle s’ouvre.

  7. Sur la page Choisir le type de modèle , choisissez Modèle d’élément, sélectionnez le projet qui contient l’élément, puis sélectionnez Suivant.

  8. Sur la page Sélectionner l’élément à exporter , choisissez l’élément pour lequel vous souhaitez créer un modèle, puis sélectionnez Suivant.

  9. Sur la page Sélectionner les références d’article , sélectionnez les références d’assemblage à inclure dans le modèle, puis sélectionnez Suivant.

  10. Sur la page Sélectionner les options du modèle :

    • Entrez le nom du modèle et la description facultative, l’image de l’icône et l’image d’aperçu.

      Les fichiers d’icônes pour les éléments sont des fichiers .ico, comme décrit dans Images et icônes pour Visual Studio. L’image d’aperçu est une image de 200 x 200 qui s’affiche dans la boîte de dialogue Ajouter un nouvel élément . Vous pouvez télécharger la bibliothèque d’images Visual Studio pour obtenir des icônes cohérentes avec le style Visual Studio.

    • Indiquez si vous souhaitez importer automatiquement le modèle dans Visual Studio et afficher une fenêtre de l’explorateur dans le dossier des fichiers de sortie.

  11. Sélectionnez Terminer.

Les fichiers de modèle sont compressés dans un fichier .zip et copiés dans le répertoire affiché dans l’assistant sous Emplacement de sortie. L’emplacement par défaut est %USERPROFILE%\Documents\Version de Visual Studio<>\Mes modèles exportés.

Si vous avez sélectionné Importer automatiquement le modèle dans Visual Studio, le fichier .zip est également ajouté au répertoire ItemTemplates de l’utilisateur. L’emplacement par défaut est %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Vous pouvez désormais utiliser le modèle d’élément dans vos projets.

Utiliser le modèle d’élément

  1. Si vous n’avez pas sélectionné Importer automatiquement le modèle dans Visual Studio lorsque vous avez créé le modèle, copiez le fichier .zip dans votre répertoire ItemTemplates . L’emplacement par défaut est %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.
  2. Fermez Visual Studio, puis rouvrez-le.
  3. Créez un nouveau projet ou ouvrez un projet existant, puis sélectionnezAjouter un nouvel élément au projet>
  4. Sélectionnez le modèle d’élément dans la boîte de dialogue Ajouter un nouvel élément . Si vous avez ajouté une description dans l’Assistant Exportation de modèle, celle-ci s’affiche sur le côté droit de la boîte de dialogue.
  5. Sélectionnez Ajouter pour ajouter l’élément de modèle à votre projet.

Modifier le fichier .vstemplate

L’Assistant crée un modèle de base, mais dans certains cas, vous devez modifier manuellement le fichier .vstemplate après l’avoir exporté. Par exemple, si vous souhaitez que l’élément apparaisse dans la boîte de dialogue Ajouter un nouvel élément pour un projet d’application Windows universelle, vous devez modifier le fichier .vstemplate .

  1. Extrayez le fichier .zip modèle d’élément exporté et ouvrez le fichier .vstemplate dans Visual Studio.
  2. Modifiez le fichier selon vos besoins. Pour un projet Windows universel C#, ajoutez <TemplateID>Microsoft.CSharp.Class</TemplateID> à l’intérieur de l’élément <TemplateData> .
  3. Enregistrez et fermez le fichier .vstemplate , puis remplacez-le dans le fichier .zip .

Activer les modèles pour des sous-types de projet spécifiques

Vous pouvez modifier le fichier .vstemplate pour spécifier que votre modèle d’élément n’apparaît que pour certains sous-types de projet, tels que Windows, Office, Base de données ou Web.

  1. Ouvrez le fichier .vstemplate pour le modifier.
  2. Ajoutez un élément ProjectSubType immédiatement après l’élément, avec la ProjectType valeur Windows, Office, Databaseou Web. Par exemple : <ProjectSubType>Database</ProjectSubType>.

L’exemple suivant montre un fichier .vstemplate pour Office les projets.

<VSTemplate Version="2.0.0" Type="Item" Version="2.0.0">
   <TemplateData>
      <Name>Class</Name>
      <Description>An empty class file</Description>
      <Icon>Class.ico</Icon>
      <ProjectType>CSharp</ProjectType>
      <ProjectSubType>Office</ProjectSubType>
      <DefaultName>Class.cs</DefaultName>
   </TemplateData>
   <TemplateContent>
      <ProjectItem>Class1.cs</ProjectItem>
   </TemplateContent>
</VSTemplate>

Créer manuellement un modèle d’élément

Au lieu d’utiliser l’assistant, vous pouvez créer un modèle d’élément manuellement à partir de zéro.

  1. Créez un projet et ajoutez un élément.
  2. Modifiez l’élément comme vous le souhaitez, par exemple en ajoutant l’endroit où le remplacement des paramètres doit avoir lieu, puis enregistrez l’élément.
  3. Créez un fichier XML et enregistrez-le avec une extension de fichier .vstemplate dans le même répertoire que le fichier d’élément de votre projet.
  4. Ajoutez les métadonnées du modèle d’élément au fichier XML .vstemplate , comme indiqué dans l’exemple précédent. Pour plus d’informations, consultez Référence du schéma de modèle (extensibilité).
  5. Enregistrez et fermez le fichier .vstemplate .
  6. Dans l’Explorateur Windows, sélectionnez les fichiers que vous souhaitez inclure dans votre modèle, y compris le fichier .vstemplate . Cliquez avec le bouton droit sur la sélection et sélectionnez Compresser le>fichier ZIP.
  7. Copiez le fichier .zip résultant et collez-le dans l’emplacement du modèle d’élément utilisateur Visual Studio. Le répertoire par défaut est %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Contenu connexe