Condividi tramite


Aggiungere tag ai modelli di progetto

A partire da Visual Studio 2019 versione 16.1 Preview 2, è possibile aggiungere tag per il linguaggio, la piattaforma e il tipo di progetto ai modelli di progetto.

I tag vengono usati in due posizioni nella finestra di dialogo Nuovo progetto:

  • I tag vengono visualizzati sotto la descrizione del modello.

    Modello di progetto con i tag nella finestra di dialogo Nuovo progetto

  • I tag consentono operazioni di ricerca e filtro per i modelli.

    Ricerca e filtro nella finestra di dialogo Nuovo progetto

È possibile aggiungere tag aggiornando il file XML con estensione vstemplate. È possibile usare i tag modello inclusi in Visual Studio o creare tag modello personalizzati. I tag modello vengono visualizzati solo nella finestra di dialogo Nuovo progetto di Visual Studio 2019. I tag modello non influiscono sulla modalità di rendering del modello nelle versioni precedenti di Visual Studio.

Aggiungere o modificare tag

È possibile aggiungere o modificare tag nel file XML con estensione vstemplate del modello di progetto quando si esegue una delle azioni seguenti:

Sintassi

<LanguageTag> Language Name </LanguageTag>
<PlatformTag> Platform Name </PlatformTag>
<ProjectTypeTag> Project Type </ProjectTypeTag>

Attributi

È possibile usare gli attributi facoltativi seguenti in scenari utente avanzati:

Attributo Descrizione
Package GUID che specifica l'ID del pacchetto di Visual Studio.
ID Specifica l'ID di risorsa di Visual Studio.

Sintassi:

<LanguageTag Package="{PackageID}" ID="ResourceID" />
<PlatformTag Package="{PackageID}" ID="ResourceID" />
<ProjectTypeTag Package="{PackageID}" ID="ResourceID" />

Elementi

Elementi figlio

Nessuno.

Elementi padre

Elemento Descrizione
TemplateData (Obbligatorio) Classifica il modello in base alla categoria e ne definisce la modalità di visualizzazione nella finestra di dialogo Nuovo progetto o Aggiungi nuovo elemento.

Valore di testo

È richiesto un valore di testo, a meno che non si usino gli attributi Package e ID.

Il testo fornisce il nome del modello.

Tag predefiniti

Visual Studio offre un elenco di tag predefiniti. Quando si aggiunge un tag predefinito, il tag esegue il rendering di una risorsa localizzata.

L'elenco seguente include i tag predefiniti disponibili in Visual Studio. I valori corrispondenti sono visualizzati tra parentesi.

Tag di lingua Tag della piattaforma Tag del tipo di progetto
C++ (cpp) Android (android) Cloud (cloud)
C# (csharp) Azure (azure) Console (console)
F# (fsharp) iOS (ios) Desktop (desktop)
Java (java) Linux (linux) Estensioni (extension)
JavaScript (javascript) macOS (macos) Giochi (games)
Python (python) tvOS (tvos) IoT (iot)
Linguaggio di query (querylanguage) Windows (windows) Libreria (library)
TypeScript (typescript) SDK per app di Windows (windowsappsdk) Machine Learning (machinelearning)
Visual Basic (visualbasic) Xbox (xbox) Dispositivi mobili (mobile)
XAML (xaml) Office (office)
Altro (other)
Servizio (service)
Test (test)
UWP (uwp)
Web (web)
WinUI (winui)

Esempio

L'esempio seguente mostra i metadati per un modello di progetto per un'applicazione Visual C#:

<VSTemplate Type="Project" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic template</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>csharp</ProjectType>
        <LanguageTag>csharp</LanguageTag>
        <PlatformTag>windows</PlatformTag>
        <PlatformTag>linux</PlatformTag>
        <PlatformTag>My Platform</PlatformTag>
        <ProjectTypeTag>console</ProjectTypeTag>
        <ProjectTypeTag>desktop</ProjectTypeTag>
    </TemplateData>
    <TemplateContent>
        <Project File="MyTemplate.csproj">
            <ProjectItem>Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <ProjectItem>Properties\AssemblyInfo.cs</ProjectItem>
            <ProjectItem>Properties\Resources.resx</ProjectItem>
            <ProjectItem>Properties\Resources.Designer.cs</ProjectItem>
            <ProjectItem>Properties\Settings.settings</ProjectItem>
            <ProjectItem>Properties\Settings.Designer.cs</ProjectItem>
        </Project>
    </TemplateContent>
</VSTemplate>

Vedi anche