Informazioni di riferimento sullo schema del manifesto del modello di Visual Studio

  • Articolo

Questo schema descrive il formato dei file manifesto del modello di Visual Studio (con estensione vstman) generati per i modelli di progetto o di elemento di Visual Studio. Lo schema descrive anche il percorso e altre informazioni pertinenti sul modello.

: poiché sono presenti directory di elementi e modelli di progetto separati, un manifesto non deve mai avere una combinazione di modelli di elemento e di progetto.

Importante

Questo manifesto è disponibile a partire da Visual Studio 2017.

Elemento VSTemplateManifest

Elemento radice del manifesto.

Attributi

  • Version: stringa che rappresenta la versione del manifesto del modello. Obbligatorio.

  • Impostazioni locali: stringa che rappresenta le impostazioni locali o le impostazioni locali del manifesto del modello. Il valore delle impostazioni locali si applica a tutti i modelli. È necessario usare un manifesto separato per ogni impostazione locale. Facoltativo.

Elementi figlio

  • VSTemplateContainer Facoltativo.

  • VSTemplateDir Facoltativo.

Elemento padre

Nessuno.

VSTemplateContainer

Contenitore degli elementi del manifesto del modello. Un manifesto ha un contenitore di modelli per ogni modello definito.

Attributi

VSTemplateType: valore stringa che specifica il tipo del modello ("Project", "Item"o "ProjectGroup"). Richiesto

Elementi figlio

  • RelativePathOnDisk: percorso relativo del file modello su disco. Questa posizione definisce anche la posizione del modello nell'albero dei modelli visualizzata nella finestra di dialogo Nuovo progetto o Nuovo elemento . Per i modelli distribuiti come directory e singoli file, questo percorso fa riferimento alla directory contenente i file modello. Per i modelli distribuiti come file ZIP , questo percorso deve essere il percorso del file ZIP .

  • **VSTemplateHeader: elemento TemplateData che descrive l'intestazione.

Elemento padre

VSTemplateManifest

VSTemplateDir

Descrive la directory in cui si trova il modello. Un manifesto può contenere più voci VSTemplateDir per fornire il nome localizzato e l'ordinamento per le directory per controllare l'aspetto nell'albero delle categorie di modelli.

A causa della progettazione, le voci VSTemplateDir dovrebbero essere visualizzate solo in manifesti non specificati nelle impostazioni locali.

Attributi

Nessuno.

Elementi figlio

  • RelativePath: percorso del modello. Può essere presente una sola voce per percorso, quindi la prima vincerà per tutti i manifesti.

  • LocalizedName: elemento NameDescriptionIcon che specifica il nome localizzato. Facoltativo.

  • SortOrder: stringa che specifica l'ordinamento. Facoltativo.

  • ParentFolderOverrideName: nome sottoposto a override della cartella padre. Facoltativo. Questo elemento ha un attributo Name , ovvero un valore stringa che specifica il nome.

Elemento padre

VSTemplateManifest

NameDescriptionIcon

Specifica il nome e la descrizione, possibilmente per i modelli localizzati. Vedere LocalizedName sopra.

Attributi

  • Pacchetto: valore stringa che specifica il pacchetto. Facoltativo.

  • ID: valore stringa che specifica l'ID. Facoltativo.

Elementi figlio

Nessuno.

Elemento padre

LocalizedName

Esempi

Il codice seguente è un esempio di file con estensione vstman del modello di progetto.

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

Il codice seguente è un esempio di file con estensione vstman del modello di elemento.

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