Référence du schéma de manifeste de modèle Visual StudioVisual Studio template manifest schema reference

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

: Comme élément distinct et les répertoires de modèle de projet, un manifeste ne devez jamais avoir 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 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 représentant la version du manifeste de modèle.Version: A string representing the version of the template manifest. Obligatoire.Required.

  • Paramètres régionaux: chaîne représentant les paramètres régionaux ou 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.The locale value applies to all templates. Vous devez utiliser un manifeste distinct pour chacun des paramètres régionaux.You must use a separate manifest for each locale. Facultatif.Optional.

Éléments enfantsChild elements

  • VSTemplateContainer facultatif.VSTemplateContainer Optional.

  • VSTemplateDir facultatif.VSTemplateDir Optional.

Élément parentParent 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 des 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éploiement en tant qu’un .zip fichier, ce chemin d’accès doit être le chemin d’accès à la .zip fichier.For templates deployed as a .zip file, this path should be the path to the .zip file.

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

Élément parentParent 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 tri de classement pour les répertoires pour contrôler leur apparence dans l’arborescence de catégorie 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, donc la première condition sera choisie pour tous les manifestes.There can be only one entry per path, so the first one will win for all manifests.

  • LocalizedName: un 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 substitué du dossier parent.ParentFolderOverrideName: The overridden name of the parent folder. Facultatif.Optional. Cet élément possède 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.

Élément parentParent 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.

Élément parentParent element

LocalizedNameLocalizedName

ExemplesExamples

Le code suivant est un exemple de modèle de projet .vstman fichier.The following code 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>  

Le code suivant est un exemple d’un modèle d’élément .vstman fichier.The following code 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>