Partilhar via


Adicionar tags a modelos de projeto

Você pode adicionar tags de idioma, plataforma e tipo de projeto aos seus modelos de projeto.

As tags são usadas em dois locais na caixa de diálogo Novo Projeto :

  • As tags aparecem sob a descrição do modelo.

    Modelo de projeto com tags na caixa de diálogo Novo Projeto

  • As tags permitem que o modelo seja pesquisado e filtrado.

    Pesquisar e filtrar na caixa de diálogo Novo Projeto

Você pode adicionar tags atualizando o arquivo XML .vstemplate . Você pode usar marcas de modelo que são incorporadas no Visual Studio ou criar marcas de modelo personalizadas. As marcas de modelo aparecem somente na caixa de diálogo Novo Projeto do Visual Studio 2019. As marcas de modelo não afetam como o modelo é renderizado em versões anteriores do Visual Studio.

Adicionar ou editar tags

Talvez você queira adicionar ou editar marcas no XML .vstemplate do seu modelo de projeto quando executar uma das seguintes ações:

Sintaxe

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

Attributes

Você pode usar os seguintes atributos opcionais em cenários de usuário avançados:

Attribute Description
Package Um GUID que especifica a ID do pacote do Visual Studio.
ID Especifica a ID do recurso do Visual Studio.

Syntax:

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

Elements

Elementos filho

Nenhum.

Elementos pai

Elemento Description
TemplateData (Obrigatório) Categoriza o modelo e define como ele é exibido na caixa de diálogo Novo Projeto ou na caixa de diálogo Adicionar Novo Item .

Valor do texto

Um valor de texto é necessário, a menos que você use os Package atributos e ID .

O texto fornece o nome do modelo.

Tags incorporadas

O Visual Studio oferece uma lista de tags internas. Quando você adiciona uma tag interna, a tag renderiza um recurso localizado.

A lista a seguir mostra marcas internas que estão disponíveis no Visual Studio. Os valores correspondentes são mostrados entre parênteses.

Marca de idioma Tag da plataforma Tag de tipo de projeto
C++ (cpp) Androide (android) Nuvem (cloud)
C# (csharp) Azure (azure) Consola (console)
F# (fsharp) iOS (ios) Área de trabalho (desktop)
Java (java) Linux (linux) Extensões (extension)
JavaScript (javascript) macOS (macos) Jogos (games)
Python (python) tvOS (tvos) Internet das coisas (iot)
Linguagem de consulta (querylanguage) Janelas (windows) Biblioteca (library)
TypeScript (typescript) SDK de aplicativos do Windows (windowsappsdk) Aprendizagem Automática (machinelearning)
Visual Basic (visualbasic) Xbox (xbox) Telemóvel (mobile)
XAML (xaml) Escritório (office)
Outros (other)
Serviço (service)
Ensaio (test)
PTU (uwp)
Web (web)
WinUI (winui)

Example

O exemplo a seguir mostra os metadados para um modelo de projeto para um aplicativo 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>

Consulte também