Informations de référence sur le schéma du manifeste du modèle Visual Studio

  • Article

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>