Création de projets et modèles d’élémentCreating Custom Project and Item Templates

Le Kit de développement logiciel Visual Studio inclut des modèles de projet que vous créez un modèle de projet personnalisé et un modèle d’élément personnalisé.The Visual Studio SDK includes project templates that create a custom project template and a custom item template. Ces modèles comprennent des substitutions de paramètre commun et créer en tant que fichiers zip.These templates include some common parameter substitutions, and build as zip files. Elles ne sont pas déployées automatiquement, et elles ne sont pas disponibles dans l’instance expérimentale.They are not automatically deployed, and they are not available in the experimental instance. Vous devez copier le fichier zip générés pour le répertoire de modèles utilisateur.You must copy the generated zip file to user template directory.

Les modèles de création de modèle vous permettent d’inclure des modèles dans les extensions supérieure.The template creation templates let you include templates in larger extensions. Cela vous permet d’implémenter le contrôle de version sur les fichiers sources et de créer un groupe de projets de modèle dans un package VSIX.This lets you implement version control on the source files and build a group of template projects into one VSIX package.

Vous pouvez également configurer un modèle pour installer les packages NuGet.You can also configure a template to install NuGet packages. Pour plus d’informations, consultez les packages NuGet dans des modèles Visual Studio.For more information, see NuGet packages in Visual Studio templates.

Pour les scénarios de création de modèle de base, vous devez utiliser le exporter le modèle Assistant, ce qui génère un fichier compressé.For basic template creation scenarios, you should use the Export Template wizard, which outputs to a compressed file. Pour plus d’informations sur la création du modèle de base, consultez création de modèles de projet et élément.For more information about basic template creation, see Creating Project and Item Templates.

Note

À partir de Visual Studio 2017, l’analyse des modèles de projets et modèles d’élément sera n’est plus effectuée.Starting in Visual Studio 2017, scanning for custom project and item templates will no longer be performed. Au lieu de cela, l’extension doit fournir les fichiers de manifeste de modèle qui décrivent l’emplacement d’installation de ces modèles.Instead, the extension must provide template manifest files that describe the install location of these templates. Vous pouvez utiliser Visual Studio 2017 pour mettre à jour vos extensions VSIX.You can use Visual Studio 2017 to update your VSIX extensions. Si vous déployez votre extension à l’aide d’un fichier MSI, vous devez générer les fichiers manifeste de modèle à la main.If you deploy your extension using an MSI, you must generate the template manifest files by hand. Pour plus d’informations, consultez mise à niveau des projets et des modèles d’élément pour Visual Studio 2017.For more information, see Upgrading Custom Project and Item Templates for Visual Studio 2017. Le schéma de modèle de manifeste est documenté dans Visual Studio Template manifeste Schema Reference.The template manifest schema is documented in Visual Studio Template Manifest Schema Reference.

Création d’un modèle de projetCreating a Project Template

  1. Créez un projet de modèle de projet.Create a Project Template project. Vous pouvez trouver le modèle de projet dans le nouveau projet boîte de dialogue, dans Visual Basic ou Visual c# extensibilité dossier.You can find the project template in the New Project dialog, in the Visual Basic or Visual C# Extensibility folder.

    Le modèle génère un fichier de classe, une icône, un fichier .vstemplate, un fichier de projet modifiable nommé ProjectTemplate.vbproj ou ProjectTemplate.csproj et certains fichiers qui sont habituellement générées par d’autres types de projet, un tel fichier resources.resx, un AssemblyInfo. et un fichier .settings.The template generates a class file, an icon, a .vstemplate file, an editable project file named ProjectTemplate.vbproj or ProjectTemplate.csproj, and some files that are typically generated by other project types, such a resources.resx file, an AssemblyInfo file, and a .settings file. Chaque fichier de code contient les substitutions de paramètre commun le cas échéant.Each code file contains common parameter substitutions where appropriate.

  2. Ajouter et supprimer des éléments à partir du projet en fonction des besoins de votre projet.Add and remove items from the project as required for your project. Ne supprimez pas le fichier projet modifiable, le fichier AssemblyInfo ou le fichier .vstemplate.Do not remove the editable project file, the AssemblyInfo file, or the .vstemplate file.

  3. Mettre à jour le fichier .vstemplate pour refléter les ajouts et les suppressions.Update the .vstemplate file to reflect any additions and deletions. Le projet élément doit contenir un ProjectItem élément pour chaque fichier à inclure dans le modèle.The Project element must contain a ProjectItem element for each file to be included in the template.

  4. Modifier vos fichiers de code et d’autres contenus de la direction de l’utilisateur et ajoutez des substitutions de paramètre appropriées.Modify your code files and other user-facing content, and add appropriate parameter substitutions.

  5. Modifier le contenu généré en fonction des besoins.Modify the generated content as required.

  6. Générez le projet.Build the project.

    Visual Studio crée un fichier .zip qui contient votre modèle.Visual Studio creates a .zip file that contains your template. Il n’est pas déployée, et il n’est pas disponible dans l’instance expérimentale.It is not deployed, and it is not available in the experimental instance.

Création d’un modèle d’élémentCreating an Item Template

  1. Créer un projet de modèle d’élément.Create an Item Template project.

    Le modèle génère un fichier de classe, une icône, un fichier .vstemplate et un fichier AssemblyInfo.The template generates a class file, an icon, a .vstemplate file, and an AssemblyInfo file. Le fichier de classe contient des substitutions de paramètre commun.The class file contains some common parameter substitutions.

  2. Ajouter et supprimer des éléments à partir du projet en fonction des besoins de votre projet.Add and remove items from the project as required for your project.

  3. Mettre à jour le fichier .vstemplate pour refléter les ajouts et les suppressions.Update the .vstemplate file to reflect any additions and deletions. Le projet élément doit contenir un ProjectItem élément pour chaque fichier à inclure dans le modèle.The Project element must contain a ProjectItem element for each file to be included in the template.

  4. Modifier vos fichiers de code et d’autres contenus de la direction de l’utilisateur et ajoutez des substitutions de paramètre appropriées.Modify your code files and other user-facing content, and add appropriate parameter substitutions.

  5. Modifier le contenu généré en fonction des besoins.Modify generated content as required.

  6. Générez le projet.Build the project.

    Visual Studio crée un fichier compressé qui contient votre modèle.Visual Studio creates a compressed file that contains your template. Il n’est pas déployée, et il n’est pas disponible dans l’instance expérimentale.It is not deployed, and it is not available in the experimental instance.

DéploiementDeployment

Pour déployer le modèle de projet ou un élémentTo deploy the project or item template

  1. Créez un projet VSIX.Create a VSIX project. Pour plus d’informations, consultez modèle de projet VSIX.For more information, see VSIX Project Template.

  2. Définissez le projet VSIX comme projet de démarrage.Set the VSIX project as the startup project. Dans le l’Explorateur de solutions, sélectionnez le nœud du projet VSIX, avec le bouton droit et sélectionnez définir comme projet de démarrage.In the Solution Explorer, select the VSIX project node, right-click, and select Set as Startup Project.

  3. Définir le projet de modèle de projet comme composant du projet VSIX.Set the project template project as an asset of the VSIX project. Ouvrez le fichier .vsixmanifest.Open the .vsixmanifest file. Accédez à la actifs onglet et cliquez sur nouveau.Go to the Assets tab and click New.

    1. Définir le Type au champ Microsoft.VisualStudio.ProjectTemplate ou Microsoft.VisualStudio.ItemTemplate.Set the Type field to Microsoft.VisualStudio.ProjectTemplate or Microsoft.VisualStudio.ItemTemplate.

    2. Pour la source, sélectionnez le un projet dans la solution actuelle option et sélectionnez le projet qui contient votre modèle.For source, select the A project in current solution option, and then select the project that contains your template.

  4. Générez la solution, appuyez sur F5.Build the solution, and press F5. L’instance expérimentale s’affiche.The experimental instance appears.

  5. Pour un projet de modèle de projet, vous devez voir votre modèle de projet répertorié dans le nouveau projet boîte de dialogue (fichier > Nouveau > projet), dans le nœud Visual Basic ou Visual c#.For a project template project, you should see your project template listed in the New Project dialog (File > New > Project), in the Visual C# or Visual Basic node. Pour un projet de modèle d’élément, vous devez voir votre modèle d’élément dans la boîte de dialogue Ajouter un nouvel élément (dans le l’Explorateur de solutions, sélectionnez le nœud du projet, cliquez sur Ajouter / nouvel élément).For an item template project, you should see your item template listed in the Add New Item dialog (in the Solution Explorer, select the project node and click Add / New Item).

Voir aussiSee Also

Référence de modèle Visual StudioVisual Studio template reference
Packages NuGet dans des modèles Visual StudioNuGet packages in Visual Studio templates