Udostępnij przez


Dodawanie tagów do szablonów projektów

Tagi języka, platformy i typu projektu można dodawać do szablonów projektów.

Tagi są używane w dwóch miejscach w oknie dialogowym Nowy projekt :

  • Tagi są wyświetlane w opisie szablonu.

    Szablon projektu z tagami w oknie dialogowym Nowy projekt

  • Tagi umożliwiają wyszukiwanie i filtrowanie szablonu.

    Wyszukiwanie i filtrowanie w oknie dialogowym Nowy projekt

Tagi można dodawać, aktualizując plik XML vstemplate . Możesz użyć tagów szablonów wbudowanych w program Visual Studio lub utworzyć niestandardowe tagi szablonów. Tagi szablonów są wyświetlane tylko w oknie dialogowym Nowy projekt programu Visual Studio 2019. Tagi szablonów nie mają wpływu na sposób renderowania szablonu we wcześniejszych wersjach programu Visual Studio.

Dodawanie lub edytowanie tagów

Jeśli wykonasz jedną z następujących akcji, możesz dodać lub edytować tagi w pliku XML szablonu projektu:

Składnia

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

Attributes

W zaawansowanych scenariuszach użytkownika można użyć następujących opcjonalnych atrybutów:

Attribute Description
Package Identyfikator GUID określający identyfikator pakietu programu Visual Studio.
ID Określa identyfikator zasobu programu Visual Studio.

Syntax:

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

Elements

Elementy podrzędne

Żaden.

Elementy nadrzędne

Składnik Description
TemplateData (Wymagane) Kategoryzuje szablon i definiuje sposób wyświetlania go w oknie dialogowym Nowy projekt lub w oknie dialogowym Dodawanie nowego elementu .

Wartość tekstowa

Wartość tekstowa jest wymagana, chyba że używasz Package atrybutów i ID .

Tekst zawiera nazwę szablonu.

Tagi wbudowane

Program Visual Studio oferuje listę wbudowanych tagów. Po dodaniu wbudowanego tagu tag renderuje zlokalizowany zasób.

Na poniższej liście przedstawiono wbudowane tagi, które są dostępne w programie Visual Studio. Odpowiednie wartości są wyświetlane w nawiasach.

Tag języka Tag platformy Tag typu projektu
C++ (cpp) Android (android) Chmura (cloud)
C# (csharp) Azure (azure) Konsola (console)
F# (fsharp) iOS (ios) Desktop (desktop)
Java (java) Linux (linux) Rozszerzenia (extension)
JavaScript (javascript) macOS (macos) Gry (games)
Python (python) tvOS (tvos) IoT (iot)
Język zapytań (querylanguage) Windows (windows) Biblioteka (library)
TypeScript (typescript) Zestaw SDK aplikacji systemu Windows (windowsappsdk) Machine Learning (machinelearning)
Visual Basic (visualbasic) Xbox (xbox) Urządzenia przenośne (mobile)
XAML (xaml) Office (office)
Inne (other)
Usługa (service)
Test (test)
UwP (uwp)
Sieć Web (web)
WinUI (winui)

Example

W poniższym przykładzie przedstawiono metadane szablonu projektu dla aplikacji 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>

Zobacz także