TemplateData, élément (modèles Visual Studio)

Article
10/10/2023

Définit la catégorie du modèle et comment il s’affiche dans la boîte de dialogue Nouveau projet ou Ajouter un nouvel élément .

Syntaxe

<TemplateData>
    <Name> ... </Name>
    <Description> ... </Description>
    <Icon> ... </Icon>
    <ProjectType> ... </ProjectType>
    ...
</TemplateData>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Aucune.

Éléments enfants

Élément	Description
Nom	Élément requis. Spécifie le nom du modèle tel qu’il apparaît dans la boîte de dialogue Nouveau projet ou Ajouter un nouvel élément .
Description	Élément requis. Spécifie la description du modèle tel qu’il apparaît dans la boîte de dialogue Nouveau projet ou Ajouter un nouvel élément .
Icône	Élément requis. Spécifie le chemin d’accès et le nom de fichier image qui sert d’icône, qui apparaît dans la boîte de dialogue Nouveau projet ou Ajouter un nouvel élément , pour le modèle.
ProjectType	Élément requis. Catégorise le modèle de projet afin qu’il apparaisse sous le groupe spécifié dans la boîte de dialogue Nouveau projet .
ProjectSubType	Élément facultatif. Classifie le modèle de projet afin qu’il apparaisse sous la sous-catégorie spécifiée dans la boîte de dialogue Nouveau projet .
TemplateID	Élément facultatif. Spécifie l’ID de modèle.
TemplateGroupID	Élément facultatif. Spécifie l’ID de groupe de modèles.
SortOrder	Élément facultatif. Spécifie une valeur utilisée pour organiser le modèle, entre autres modèles de la même catégorie, comme il apparaît dans la boîte de dialogue Nouveau projet ou Ajouter un nouvel élément .
CreateNewFolder	Élément facultatif. Spécifie si un dossier contenant est créé lors de l’instanciation du projet.
DefaultName	Élément facultatif. Spécifie le nom généré par le système de projet Visual Studio pour le projet ou l’élément lors de sa création.
ProvideDefaultName	Élément facultatif. Spécifie si le système de projet Visual Studio génère le nom par défaut d’un projet ou d’un élément lors de sa création.
PromptForSaveOnCreation	Élément facultatif. Spécifie si le projet peut être créé en tant que projet temporaire (Visual Studio 2017 uniquement).
EnableLocationBrowseButton	Élément facultatif. Spécifie si le bouton Parcourir est disponible dans la boîte de dialogue Nouveau projet afin que les utilisateurs puissent facilement modifier le répertoire par défaut dans lequel un nouveau projet est enregistré.
Hidden	Élément facultatif. Spécifie si le modèle apparaît dans la boîte de dialogue Nouveau projet ou Ajouter un nouvel élément .
NumberOfParentCategoriesToRollUp	Élément facultatif. Spécifie le nombre de catégories parentes qui affichent le modèle dans la boîte de dialogue Nouveau projet .
LocationFieldMRUPrefix	Élément facultatif.
LocationField	Élément facultatif. Spécifie si la zone de texte Emplacement de la boîte de dialogue Nouveau projet est activée, désactivée ou masquée pour le modèle de projet.
RequiredFrameworkVersion	Élément facultatif. Utilisez cet élément si le modèle prend uniquement en charge une version minimale spécifique et les versions ultérieures, le cas échéant, du .NET Framework.
SupportsMasterPage	Élément facultatif. Spécifie si le modèle prend en charge une page maître pour les projets web.
SupportsCodeSeparation	Élément facultatif. Spécifie si le modèle prend en charge la séparation du code ou le modèle de page code-behind pour les projets web.
SupportsLanguageDropDown	Élément facultatif. Spécifie si le modèle est identique pour plusieurs langues et si l’option Langue est disponible dans la boîte de dialogue Nouveau projet .
TargetPlatformName	Élément facultatif. Spécifie la plateforme ciblée par le modèle de projet. Cet élément spécifie qu’un modèle de projet est utilisé pour créer des applications du Windows 8.x Store.

Éléments parents

Élément	Description
VSTemplate	Élément requis. Contient toutes les métadonnées du modèle de projet, du modèle d’élément ou du kit de démarrage.

Notes

TemplateData est un élément obligatoire.

Si vous n’incluez pas d’élément facultatif, la valeur par défaut de cet élément est utilisée.

Exemple

L’exemple suivant montre les métadonnées d’un modèle de projet pour une application Visual C#.

<VSTemplate Type="Project" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic starter kit</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
    </TemplateData>
    <TemplateContent>
        <Project File="MyStarterKit.csproj">
            <ProjectItem>Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <ProjectItem>Properties\AssemblyInfo.cs</ProjectItem>
            <ProjectItem>Properties\Resources.resx</ProjectItem>
            <ProjectItem>Properties\Resources.Designer.cs</ProjectItem>
            <ProjectItem>Properties\Settings.settings</ProjectItem>
            <ProjectItem>Properties\Settings.Designer.cs</ProjectItem>
        </Project>
    </TemplateContent>
</VSTemplate>