Guide pratique pour créer des modèles d’élémentHow to: Create item templates

Cette rubrique vous montre comment créer un modèle d’élément à l’aide de l’Assistant Exportation de modèle.This topic shows you how to create an item template by using the Export Template Wizard. Si votre modèle se compose de plusieurs fichiers, consultez Guide pratique pour créer des modèles d’élément multifichier.If your template will consist of multiple files, see How to: Create Multi-file Item Templates.

Pour ajouter un modèle d’élément utilisateur à la boîte de dialogue Ajouter un nouvel élémentTo add a user item template to the Add New Item dialog box

  1. Créez ou ouvrez un projet dans Visual Studio.Create or open a project in Visual Studio.

  2. Ajoutez un élément au projet et modifiez-le si vous le souhaitez.Add an item to the project, and modify it if you want to.

  3. Modifiez le fichier de code pour indiquer où le remplacement de paramètres doit avoir lieu.Modify the code file to indicate where parameter replacement should take place. Pour plus d’informations, consultez Guide pratique pour substituer des paramètres dans un modèle.For more information, see How to: Substitute parameters in a template.

  4. Dans le menu Projet, choisissez Exporter le modèle...On the Project menu, choose Export Template...

  5. Dans la page Choisir un type de modèle choisissez Modèle d’élément, sélectionnez le projet qui contient l’élément, puis choisissez Suivant.On the Choose Template Type page, choose Item Template, select the project that contains the item, and then choose Next.

  6. Dans la page Sélectionner l’élément à exporter, choisissez l’élément pour lequel créer un modèle, puis choisissez Suivant.On the Select Item To Export page, choose the item you want to create a template for, and then choose Next.

  7. Dans la page Sélectionner les références aux éléments, sélectionnez les références d’assembly à inclure dans le modèle, puis choisissez Suivant.On the Select Item References page, select the assembly references to include in the template, and then choose Next.

  8. Dans la page Sélectionner les options du modèle, entrez le nom du modèle et éventuellement une description, une image d’icône et une image d’aperçu, puis choisissez Terminer.On the Select Template Options page, enter the template name and optional description, icon image and preview image, and then choose Finish.

    Les fichiers du modèle sont ajoutés à un fichier .zip et copiés dans le répertoire que vous spécifiez dans l’Assistant.The files for the template are added to a .zip file and copied to the directory you specified in the wizard. L’emplacement par défaut est %USERPROFILE%\Documents\Visual Studio <version>\My Exported Templates.The default location is %USERPROFILE%\Documents\Visual Studio <version>\My Exported Templates.

  9. Si vous n’avez pas sélectionné l’option Importer automatiquement le modèle dans Visual Studio dans l’Assistant Exportation de modèle, recherchez le modèle exporté et copiez-le dans le répertoire de modèles d’élément utilisateur.If you did not select the option Automatically import the template into Visual Studio in the Export Template Wizard, locate the exported template and copy it to the user item template directory. L’emplacement par défaut est %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.The default location is %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

  10. Fermez Visual Studio, puis rouvrez-le.Close Visual Studio and then reopen it.

  11. Créez un projet, ou ouvrez un projet existant, puis choisissez Projet > Ajouter un nouvel élément... ou appuyez sur Ctrl + Maj + A.Create a new project, or open an existing project, and then choose Project > Add New Item... or press Ctrl + Shift + A.

    Le modèle d’élément apparaît dans la boîte de dialogue Ajouter un nouvel élément.The item template appears in the Add New Item dialog box. Si vous avez ajouté une description dans l’Assistant Exportation de modèle, la description s’affiche dans la partie droite de la boîte de dialogue.If you added a description in the Export Template Wizard, the description appears on the right side of the dialog box.

Pour permettre l’utilisation du modèle d’élément dans un projet d’application Windows universelleTo enable the item template to be used in a Universal Windows App project

L’Assistant effectue une grande partie du travail nécessaire pour créer un modèle de base mais, dans de nombreux cas, vous devez modifier manuellement le fichier .vstemplate après avoir exporté le modèle.The wizard does much of the work to create a basic template, but in many cases you need to manually modify the .vstemplate file after you have exported the template. Par exemple, si vous souhaitez que l’élément s’affiche dans la boîte de dialogue Ajouter un nouvel élément pour un projet d’application Windows universelle, vous devez effectuer quelques étapes supplémentaires.For example, if you want the item to appear in the Add New Item dialog for a Universal Windows App project, you have to perform a few extra steps.

  1. Suivez les étapes de la section précédente pour exporter un modèle d’élément.Follow the steps in the previous section to export an item template.

  2. Extrayez le fichier .zip qui a été créé, puis ouvrez le fichier .vstemplate dans Visual Studio.Extract the .zip file that was created, and open the .vstemplate file in Visual Studio.

  3. Pour un projet Windows universel C#, ajoutez le code XML suivant à l’intérieur de l’élément <TemplateData> :For a C# Universal Windows project, add the following XML inside the <TemplateData> element:

    <TemplateID>Microsoft.CSharp.Class</TemplateID>
    
  4. Dans Visual Studio, enregistrez le fichier .vstemplate, puis fermez-le.In Visual Studio, save the .vstemplate file and close it.

  5. Copiez et collez le fichier .vstemplate dans le fichier .zip d’origine.Copy and paste the .vstemplate file back to the .zip file.

    Si la boîte de dialogue Copier le fichier apparaît, sélectionnez l’option Copier et remplacer.If the Copy File dialog box appears, choose the Copy and Replace option.

Vous pouvez maintenant ajouter un élément basé sur ce modèle à un projet Windows universel à partir de la boîte de dialogue Ajouter un nouvel élément.You can now add an item based on this template to a Universal Windows project from the Add New Item dialog box.

Pour activer les modèles pour des sous-types de projet spécifiquesTo enable templates for specific project subtypes

Vous pouvez spécifier que votre modèle doit uniquement apparaître pour certains sous-types de projet, comme Windows, Office, Base de données ou Web.You can specify that your template should only appear for only certain project subtypes, such as Windows, Office, Database, or Web.

  1. Localisez l'élément ProjectType dans le fichier .vstemplate du modèle d'élément.Locate the ProjectType element in the .vstemplate file for the item template.

  2. Ajoutez un élément ProjectSubType immédiatement après l’élément ProjectType.Add a ProjectSubType element immediately after the ProjectType element.

  3. Affectez au texte de l'élément l'une des valeurs suivantes :Set the text value of the element to one of the following values:

    • WindowsWindows
    • OfficeOffice
    • Base de donnéesDatabase
    • WebWeb

Par exemple : <ProjectSubType>Database</ProjectSubType>.For example: <ProjectSubType>Database</ProjectSubType>.

L’exemple suivant présente un modèle d’élément disponible pour les projets Office.The following example shows an item template for Office projects.

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

Pour créer manuellement un modèle d’élément sans utiliser l’Assistant Exportation de modèleTo manually create an item template without using the Export Template Wizard

Dans certains cas, vous pouvez avoir envie de créer un modèle d’élément manuellement, à partir de zéro.In some cases you may want to create an item template manually, from scratch.

  1. Créez un projet et un élément de projet.Create a project and project item.

  2. Modifiez l'élément de projet jusqu'à ce qu'il soit prêt à être enregistré en tant que modèle.Modify the project item until it is ready to be saved as a template.

  3. Modifiez le fichier de code pour indiquer où le remplacement de paramètres doit avoir lieu, le cas échéant.Modify the code file to indicate where parameter replacement should occur, if anywhere. Pour plus d’informations sur le remplacement de paramètres, consultez Comment : substituer des paramètres dans un modèle.For more information about parameter replacement, see How to: Substitute Parameters in a Template.

  4. Créez un fichier XML et enregistrez-le avec une extension de fichier .vstemplate dans le même répertoire que votre fichier d’élément de projet.Create an XML file and save it with a .vstemplate file extension in the same directory as your project item file.

  5. Modifiez le fichier XML .vstemplate pour fournir des métadonnées de modèle d’élément.Edit the .vstemplate XML file to provide item template metadata. Pour plus d’informations, consultez Informations de référence sur les schémas de modèles (extensibilité) et l’exemple de la section précédente.For more information, see Template schema reference (Extensibility) and the example in the previous section.

  6. Enregistrez le fichier .vstemplate, puis fermez-le.Save the .vstemplate file and close it.

  7. Dans l’Explorateur Windows, sélectionnez les fichiers à inclure dans votre modèle, cliquez avec le bouton droit sur la sélection, puis choisissez Envoyer vers > Dossier compressé.In Windows Explorer, select the files you want to include in your template, right-click the selection, and choose Send to > Compressed (zipped) folder. Les fichiers que vous avez sélectionnés sont compressés dans un fichier .zip.The files that you selected are compressed into a .zip file.

  8. Copiez le fichier .zip et collez-le à l'emplacement du modèle d'élément utilisateur.Copy the .zip file and paste it in the user item template location. Dans Visual Studio 2017, le répertoire par défaut est %USERPROFILE%\Documents\Visual Studio 2017\Templates\ItemTemplates.In Visual Studio 2017, the default directory is %USERPROFILE%\Documents\Visual Studio 2017\Templates\ItemTemplates. Pour plus d’informations, consultez Guide pratique pour localiser et organiser les modèles de projet et d’élément.For more information, see How to: Locate and Organize Project and Item Templates.

Voir aussiSee also

Création de modèles de projet et d’élémentCreating Project and Item Templates
Guide pratique pour créer des modèles d’élément multifichierHow to: Create Multi-file Item Templates
Informations de référence sur les schémas de modèles Visual Studio (extensibilité)Visual Studio Template Schema Reference (Extensibility)