Référence de schéma de manifeste de modèle Visual StudioVisual Studio Template Manifest Schema Reference

Ce schéma décrit le format des fichiers de manifeste (.vstman) de modèle Visual Studio générés pour les modèles de projet ou un élément de Visual Studio et décrit l’emplacement et autres informations pertinentes relatives au modèle.This schema describes the format of the Visual Studio template manifest (.vstman) files generated for Visual Studio project or item templates, and describes the location and other relevant information about the template.

: Étant donné qu’élément distinct et les répertoires de modèle de projet, un manifeste doit avoir jamais une combinaison des modèles de projet et d’élément.: Because there are separate item and project template directories, a manifest should never have a mix of item and project templates.

Important

Ce manifeste n’est disponible à partir de Visual Studio 2017.This manifest is available starting in Visual Studio 2017.

Élément de VSTemplateManifestVSTemplateManifest Element

L’élément racine du manifeste.The root element of the manifest.

AttributsAttributes

  • Version: une chaîne qui représente la version du manifeste de modèle.Version: A string representing the version of the template manifest. Obligatoire.Required.

  • Paramètres régionaux: une chaîne qui représente les paramètres régionaux ou les paramètres régionaux du manifeste de modèle.Locale: A string representing the locale or locales of the template manifest. La valeur de paramètres régionaux s’applique à tous les modèles, vous devez utiliser un manifeste distinct pour chacun des paramètres régionaux.The locale value applies to all templates, so you must use a separate manifest for each locale. Facultatif.Optional.

Éléments enfantsChild Elements

  • VSTemplateContainer facultatif.VSTemplateContainer Optional.

  • VSTemplateDir facultatif.VSTemplateDir Optional.

Parent, élémentParent Element

Aucun.None.

VSTemplateContainerVSTemplateContainer

Le conteneur du modèle de manifeste des éléments.The container of the template manifest elements. Un manifeste est un conteneur de modèle pour chaque modèle, qu'il définit.A manifest has one template container for each template it defines.

AttributsAttributes

VSTemplateType : une valeur de chaîne qui spécifie le type du modèle ("Project", "Item", ou "ProjectGroup").VSTemplateType : A string value that specifies the type of the template ("Project", "Item", or "ProjectGroup"). ObligatoireRequired

Éléments enfantsChild Elements

  • RelativePathOnDisk: le chemin d’accès relatif du fichier de modèle sur le disque.RelativePathOnDisk: The relative path of the template file on disk. Cet emplacement définit également la position du modèle dans l’arborescence de modèle indiqué dans le nouveau projet ou un nouvel élément boîte de dialogue.This location also defines the placement of the template in the template tree shown in the New Project or New Item dialog. Pour les modèles déployés en tant qu’un répertoire et les fichiers individuels, ce chemin d’accès fait référence au répertoire contenant les fichiers de modèle.For templates deployed as a directory and individual files, this path refers to the directory containing the template files. Pour les modèles déployés en tant qu’un fichier .zip, ce chemin d’accès doit être le chemin d’accès au fichier .zip.For templates deployed as a .zip file, this path should be the path to the .zip file.

  • VSTemplateHeader : A TemplateData élément qui décrit l’en-tête.VSTemplateHeader : A TemplateData element that describes the header.

Parent, élémentParent Element

VSTemplateManifestVSTemplateManifest

VSTemplateDirVSTemplateDir

Décrit le répertoire où se trouve le modèle.Describes the directory where the template is located. Un manifeste peut contenir plusieurs VSTemplateDir entrées pour fournir le nom localisé et ordre pour les répertoires de tri pour contrôler leur aspect dans l’arborescence des catégories de modèle.A manifest can contain multiple VSTemplateDir entries to provide localized name and sort ordering for directories to control their appearance in template category tree.

En raison de leur conception, VSTemplateDir entrées doivent apparaître uniquement dans les types de paramètres régionaux des manifestes spécifiés.Due to their design, VSTemplateDir entries should appear only in non-locale specified manifests.

AttributsAttributes

Aucun.None.

Éléments enfantsChild Elements

  • RelativePath: le chemin d’accès du modèle.RelativePath: The path of the template. Il peut y avoir qu’une seule entrée par le chemin d’accès, pour la première condition précédente pour tous les manifestes.There can be only one entry per path, so the first one will win for all manifests.

  • LocalizedName: A NameDescriptionIcon élément qui spécifie le nom localisé.LocalizedName: A NameDescriptionIcon element that specifies the localized name. Facultatif.Optional.

  • SortOrder : chaîne qui spécifie l’ordre de tri.SortOrder :A string that specifies the sort order. Facultatif.Optional.

  • ParentFolderOverrideName: le nom du dossier parent de substituée.ParentFolderOverrideName: The overridden name of the parent folder. Facultatif.Optional. Cet élément a un nom attribut, qui est une valeur de chaîne qui spécifie le nom.This element has a Name attribute, which is a string value that specifies the name.

Parent, élémentParent Element

VSTemplateManifestVSTemplateManifest

NameDescriptionIconNameDescriptionIcon

Spécifie le nom et la description, éventuellement pour les modèles localisés.Specifies the name and description, possibly for localized templates. Consultez LocalizedName ci-dessus.See LocalizedName above.

AttributsAttributes

  • Package: une valeur de chaîne qui spécifie le package.Package: A string value that specifies the package. Facultatif.Optional.

  • ID: une valeur de chaîne qui spécifie l’ID.ID: A string value that specifies the ID. Facultatif.Optional.

Éléments enfantsChild Elements

Aucun.None.

Parent, élémentParent Element

LocalizedNameLocalizedName

ExemplesExamples

Voici un exemple d’un fichier de .vstman de modèle de projet.The following is an example of a project template .vstman file.

<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>  

Voici un exemple d’un fichier de modèle d’élément .vstman.The following is an example of an item template .vstman file.

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>