Informations de référence sur le schéma du manifeste du modèle Visual Studio
Ce schéma décrit le format des fichiers manifeste de modèle Visual Studio (.vstman) générés pour les modèles de projet ou d’élément Visual Studio. Le schéma décrit également l’emplacement et d’autres informations pertinentes sur le modèle.
: étant donné qu’il existe des répertoires de modèles d’élément et de projet distincts, un manifeste ne doit jamais avoir un mélange d’éléments et de modèles de projet.
Important
Ce manifeste est disponible à partir de Visual Studio 2017.
Élément VSTemplateManifest
Élément racine du manifeste.
Attributs
Version : chaîne représentant la version du manifeste du modèle. Obligatoire.
Paramètres régionaux : chaîne représentant les paramètres régionaux ou les paramètres régionaux du manifeste de modèle. La valeur des paramètres régionaux s’applique à tous les modèles. Vous devez utiliser un manifeste distinct pour chaque paramètre régional. facultatif.
Éléments enfants
VSTemplateContainer facultatif.
VSTemplateDir Facultatif.
Élément parent
Aucun.
VSTemplateContainer
Conteneur des éléments de manifeste de modèle. Un manifeste a un conteneur de modèles pour chaque modèle qu’il définit.
Attributs
VSTemplateType : valeur de chaîne qui spécifie le type du modèle ("Project"
, "Item"
ou "ProjectGroup"
). Requis
Éléments enfants
RelativePathOnDisk : chemin relatif du fichier de modèle sur le disque. Cet emplacement définit également le positionnement du modèle dans l’arborescence du modèle affiché dans la boîte de dialogue Nouveau projet ou Nouvel élément . Pour les modèles déployés en tant que répertoire et fichiers individuels, ce chemin fait référence au répertoire contenant les fichiers de modèle. Pour les modèles déployés en tant que fichier .zip , ce chemin doit être le chemin d’accès au fichier .zip .
**VSTemplateHeader : élément TemplateData qui décrit l’en-tête.
Élément parent
VSTemplateManifest
VSTemplateDir
Décrit le répertoire où se trouve le modèle. Un manifeste peut contenir plusieurs entrées VSTemplateDir pour fournir un nom localisé et un ordre de tri pour les répertoires afin de contrôler leur apparence dans l’arborescence des catégories de modèles.
En raison de leur conception, les entrées VSTemplateDir doivent apparaître uniquement dans les manifestes non spécifiés par les paramètres régionaux.
Attributs
Aucune.
Éléments enfants
RelativePath : chemin d’accès du modèle. Il ne peut y avoir qu’une seule entrée par chemin, donc la première gagnera pour tous les manifestes.
LocalizedName : élément NameDescriptionIcon qui spécifie le nom localisé. facultatif.
SortOrder : chaîne qui spécifie l’ordre de tri. facultatif.
ParentFolderOverrideName : nom substitué du dossier parent. facultatif. Cet élément a un attribut Name , qui est une valeur de chaîne qui spécifie le nom.
Élément parent
VSTemplateManifest
NameDescriptionIcon
Spécifie le nom et la description, éventuellement pour les modèles localisés. Voir LocalizedName ci-dessus.
Attributs
Package : valeur de chaîne qui spécifie le package. facultatif.
ID : valeur de chaîne qui spécifie l’ID. facultatif.
Éléments enfants
Aucun.
Élément parent
LocalizedName
Exemples
Le code suivant est un exemple de fichier .vstman de modèle de projet.
<VSTemplateManifest Version="1.0" Locale="1033" xmlns="http://schemas.microsoft.com/developer/vstemplatemanifest/2015">
<VSTemplateContainer TemplateType="Project">
<RelativePathOnDisk>CSharp\1033\TestProjectTemplate</RelativePathOnDisk>
<TemplateFileName>TestProjectTemplate.vstemplate</TemplateFileName>
<VSTemplateHeader>
<TemplateData xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
<Name>TestProjectTemplate</Name>
<Description>TestProjectTemplate</Description>
<Icon>TestProjectTemplate.ico</Icon>
<ProjectType>CSharp</ProjectType>
<RequiredFrameworkVersion>2.0</RequiredFrameworkVersion>
<SortOrder>1000</SortOrder>
<TemplateID>aac0aeea-7883-4003-992f-937d53d70ab1</TemplateID>
<CreateNewFolder>true</CreateNewFolder>
<DefaultName>TestProjectTemplate</DefaultName>
<ProvideDefaultName>true</ProvideDefaultName>
</TemplateData>
</VSTemplateHeader>
</VSTemplateContainer>
</VSTemplateManifest>
Le code suivant est un exemple de fichier .vstman de modèle d’élément.
<VSTemplateManifest Version="1.0" Locale="1033" xmlns="http://schemas.microsoft.com/developer/vstemplatemanifest/2015">
<VSTemplateContainer TemplateType="Item">
<RelativePathOnDisk>CSharp\1033\ItemTemplate1</RelativePathOnDisk>
<TemplateFileName>ItemTemplate1.vstemplate</TemplateFileName>
<VSTemplateHeader>
<TemplateData xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
<Name>ItemTemplate1</Name>
<Description>ItemTemplate1</Description>
<Icon>ItemTemplate1.ico</Icon>
<TemplateID>bfeadf8e-a251-4109-b605-516b88e38c8d</TemplateID>
<ProjectType>CSharp</ProjectType>
<RequiredFrameworkVersion>2.0</RequiredFrameworkVersion>
<NumberOfParentCategoriesToRollUp>1</NumberOfParentCategoriesToRollUp>
<DefaultName>Class.cs</DefaultName>
</TemplateData>
</VSTemplateHeader>
</VSTemplateContainer>
</VSTemplateManifest>