Créer des modèles de projet et d’élément personnalisésCreate custom project and item templates

Le SDK Visual Studio inclut des modèles de projet de créer 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 incluent des substitutions de paramètre commun et générer en tant que fichiers zip.These templates include some common parameter substitutions, and build as zip files. Ils ne sont pas automatiquement déployés, et ils 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é dans le répertoire de modèle utilisateur.You must copy the generated zip file to the user template directory.

Les modèles de création de modèle vous permettent d’inclure des modèles dans des extensions plus volumineuses.The template creation templates let you include templates in larger extensions. Cela vous permet d’implémenter le contrôle de version dans les fichiers source 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 packages NuGet dans les 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 Export Template Assistant, qui envoie le résultat vers 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 de modèle de base, consultez création de modèles de projet et d’élément.For more information about basic template creation, see Creating project and item templates.

Note

À partir de Visual Studio 2017, l’analyse pour les modèles de projets et modèles d’élément est 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 manuellement les fichiers manifeste de modèle.If you deploy your extension using an MSI, you must generate the template manifest files by hand. Pour plus d’informations, consultez mise à niveau projet et élément de modèles personnalisés pour Visual Studio 2017.For more information, see Upgrad custom project and item templates for Visual Studio 2017. Le schéma de manifeste de modèle est documenté dans référence de schéma de manifeste de modèle Visual Studio.The template manifest schema is documented in Visual Studio template manifest schema reference.

Créer un modèle de projetCreate 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, une .vstemplate de fichiers, un fichier de projet modifiable nommé ProjectTemplate.vbproj ou ProjectTemplate.csprojet certains fichiers qui sont généralement générés par d’autres types de projet, tel un resources.resx fichier, un AssemblyInfo fichier et un .settings fichier.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 des 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, la AssemblyInfo fichier, ou le .vstemplate fichier.Do not remove the editable project file, the AssemblyInfo file, or the .vstemplate file.

  3. Mise à jour le .vstemplate fichier afin de 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 visibles par l’utilisateur et ajoutez des substitutions de paramètre appropriée.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 .zip fichier 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éer un modèle d’élémentCreate 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, une .vstemplate fichier et un AssemblyInfo fichier.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. Mise à jour le .vstemplate fichier afin de 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 visibles par l’utilisateur et ajoutez des substitutions de paramètre appropriée.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, puis 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éfinissez le projet de modèle de projet en tant qu’actif du projet VSIX.Set the project template project as an asset of the VSIX project. Ouvrez le .vsixmanifest fichier.Open the .vsixmanifest file. Accédez à la actifs onglet et cliquez sur New.Go to the Assets tab and click New.

    1. Définir le Type 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, puis 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érer la solution, puis 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 > New > 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 répertoriée dans le ajouter un nouvel élément boîte de dialogue.For an item template project, you should see your item template listed in the Add New Item dialog. Pour afficher le ajouter un nouvel élément boîte de dialogue, à partir de la l’Explorateur de solutions, sélectionnez le nœud du projet, puis cliquez sur ajouter > unnouvelélément).To view the Add New Item dialog, from 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 les modèles Visual StudioNuGet packages in Visual Studio templates