Compartilhar via


Adicionar marcas a modelos de projeto

Você pode adicionar marcas de tipo de linguagem, plataforma e projeto aos modelos de projeto.

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

  • As marcas aparecem na descrição do modelo.

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

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

    Pesquisar e filtrar na caixa de diálogo Novo Projeto

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

Adicionar ou editar marcas

Talvez você queira adicionar ou editar marcas no XML .vstemplate do modelo de projeto ao 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 avançados de usuário:

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.

Marcas internas

O Visual Studio oferece uma lista de marcas internas. Quando você adiciona uma marca interna, a marca 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 Marca de plataforma Marca de tipo de projeto
C++ (cpp) Android (android) Nuvem (cloud)
C# (csharp) Azure (azure) Console (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) IoT (iot)
Linguagem de Consulta (querylanguage) Windows (windows) Biblioteca (library)
TypeScript (typescript) SDK do Aplicativo do Windows (windowsappsdk) Machine Learning (machinelearning)
Visual Basic (visualbasic) Xbox (xbox) Móvel (mobile)
XAML (xaml) Office (office)
Outros (other)
Serviço (service)
Teste (test)
UWP (uwp)
Web (web)
WinUI (winui)

Example

O exemplo a seguir mostra os metadados de 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