Freigeben über


Hinzufügen von Tags zu Projektvorlagen

Sie können Ihren Projektvorlagen Sprach-, Plattform- und Projekttyptags hinzufügen.

Tags werden an zwei Stellen im Dialogfeld "Neues Projekt " verwendet:

  • Tags werden unter der Vorlagenbeschreibung angezeigt.

    Projektvorlage mit Tags im Dialogfeld

  • Tags ermöglichen das Durchsuchen und Filtern der Vorlage.

    Suchen und Filtern im Dialogfeld

Sie können Tags hinzufügen, indem Sie die XML-Datei .vstemplate aktualisieren. Sie können vorlagentags verwenden, die in Visual Studio integriert sind, oder benutzerdefinierte Vorlagentags erstellen. Vorlagentags werden nur im Dialogfeld "Neues Projekt " in Visual Studio 2019 angezeigt. Vorlagentags wirken sich nicht darauf aus, wie die Vorlage in früheren Versionen von Visual Studio gerendert wird.

Hinzufügen oder Bearbeiten von Tags

Möglicherweise möchten Sie Tags in der VSTEMPLATE-XML Ihrer Projektvorlage hinzufügen oder bearbeiten, wenn Sie eine der folgenden Aktionen ausführen:

Syntax

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

Attribute

Sie können die folgenden optionalen Attribute in erweiterten Benutzerszenarien verwenden:

Merkmal Description
Package Eine GUID, die die Visual Studio-Paket-ID angibt.
ID Gibt die Visual Studio-Ressourcen-ID an.

Syntax:

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

Elemente

Untergeordnete Elemente

Keiner.

Übergeordnete Elemente

Element Description
TemplateData (Erforderlich) Kategorisiert die Vorlage und definiert, wie sie im Dialogfeld " Neues Projekt " oder im Dialogfeld " Neues Element hinzufügen " angezeigt wird.

Textwert

Ein Textwert ist erforderlich, es sei denn, Sie verwenden die Package Attribute.ID

Der Text enthält den Namen der Vorlage.

Integrierte Tags

Visual Studio bietet eine Liste integrierter Tags. Wenn Sie ein integriertes Tag hinzufügen, rendert das Tag eine lokalisierte Ressource.

In der folgenden Liste sind integrierte Tags aufgeführt, die in Visual Studio verfügbar sind. Entsprechende Werte werden in Klammern angezeigt.

Sprachtag Plattformtag Projekttyptag
C++ (cpp) Android (android) Cloud (cloud)
C# (csharp) Azure (azure) Konsole (console)
F# (fsharp) iOS (ios) Desktop (desktop)
Java (java) Linux (linux) Erweiterungen (extension)
JavaScript (javascript) macOS (macos) Spiele (games)
Python (python) tvOS (tvos) IoT (iot)
Abfragesprache (querylanguage) Windows (windows) Bibliothek (library)
TypeScript (typescript) Windows App SDK (windowsappsdk) Maschinelles Lernen (machinelearning)
Visual Basic (visualbasic) Xbox (xbox) Mobil (mobile)
XAML (xaml) Office (office)
Sonstige (other)
Dienst (service)
Test (test)
UWP (uwp)
Web (web)
WinUI (winui)

Example

Das folgende Beispiel zeigt die Metadaten für eine Projektvorlage für eine Visual C#-Anwendung:

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

Siehe auch