Compartilhar via

Criar modelos de item

Este artigo mostra como criar um modelo de item usando o Assistente de Modelo de Exportação ou manualmente e como editar e usar modelos de item. Se o modelo consistir em vários arquivos, consulte também Como criar modelos de itens de vários arquivos.

Adicionar um modelo de item

  1. Crie ou abra um projeto no Visual Studio.

  2. Selecione> Projeto+ ou pressione Ctrl+ShiftA.

  3. Na caixa de diálogo Adicionar Novo Item , selecione um item e, em seguida, selecione Adicionar para adicioná-lo ao projeto.

  4. Modifique o item conforme desejado e indique onde no item, se em qualquer lugar, a substituição de parâmetro deve ocorrer. Para obter mais informações, consulte Como substituir parâmetros em um modelo.

  5. Salve o item.

  6. Selecione Modelode>. O Assistente de Modelo de Exportação é aberto.

  7. Na página Escolher Tipo de Modelo , escolha Modelo de Item, selecione o projeto que contém o item e selecione Avançar.

  8. Na página Selecionar Item para Exportar , escolha o item para o qual deseja criar um modelo e selecione Avançar.

  9. Na página Selecionar Referências de Item , selecione todas as referências de assembly a serem incluídas no modelo e selecione Avançar.

  10. Na página Selecionar Opções de Modelo :

    • Insira o nome do modelo e a descrição opcional, a imagem do ícone e a imagem de visualização.

      Arquivos de ícone para itens são .ico arquivos, conforme descrito em Imagens e ícones do Visual Studio. A imagem de visualização é uma imagem 200 x 200 que aparece na caixa de diálogo Adicionar Novo Item . Você pode baixar a biblioteca de imagens do Visual Studio para obter ícones consistentes com o estilo do Visual Studio.

    • Selecione se o modelo será importado automaticamente para o Visual Studio e exibir uma janela do explorer na pasta de arquivos de saída.

  11. Selecione Concluir.

Os arquivos de modelo são compactados em um arquivo .zip e copiados para o diretório mostrado no assistente no local de saída. O local padrão é %USERPROFILE%\Documents\Visual Studio <version>\My Exported Templates.

Se você selecionou importar automaticamente o modelo para o Visual Studio, o arquivo .zip também será adicionado ao diretório ItemTemplates do usuário. O local padrão é %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Agora você pode usar o modelo de item em seus projetos.

Usar o modelo de item

  1. Se você não tiver selecionado importar automaticamente o modelo para o Visual Studio ao criar o modelo, copie o arquivo .zip para o diretório ItemTemplates . O local padrão é %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.
  2. Feche o Visual Studio e, em seguida, reabra-o.
  3. Criar um novo projeto ou abrir um projeto existente e selecionar Project>Add New Item
  4. Selecione o modelo de item na caixa de diálogo Adicionar Novo Item . Se você adicionou uma descrição no Assistente para Exportar Modelo, a descrição será exibida no lado direito da caixa de diálogo.
  5. Selecione Adicionar para adicionar o item de modelo ao seu projeto.

Editar o arquivo .vstemplate

O assistente cria um modelo básico, mas em alguns casos você precisa modificar manualmente o arquivo .vstemplate depois de exportar o modelo. Por exemplo, se você quiser que o item apareça na caixa de diálogo Adicionar Novo Item para um projeto do Aplicativo Universal do Windows, edite o arquivo .vstemplate .

  1. Extraia o modelo de item exportado .zip arquivo e abra o arquivo .vstemplate no Visual Studio.
  2. Edite o arquivo conforme necessário. Para um projeto universal do Windows em C#, adicione <TemplateID>Microsoft.CSharp.Class</TemplateID> dentro do <TemplateData> elemento.
  3. Salve e feche o arquivo .vstemplate e substitua-o no arquivo .zip .

Habilitar modelos para subtipos de projeto específicos

Você pode editar o arquivo .vstemplate para especificar que o modelo de item aparece apenas para determinados subtipos de projeto, como Windows, Office, Banco de Dados ou Web.

  1. Abra o arquivo .vstemplate para edição.
  2. Adicione um elemento ProjectSubType imediatamente após o ProjectType elemento, com valor Windows, Office, Databaseou Web. Por exemplo: <ProjectSubType>Database</ProjectSubType>.

O exemplo a seguir mostra um arquivo .vstemplate para Office projetos.

<VSTemplate Version="2.0.0" Type="Item" Version="2.0.0">
   <TemplateData>
      <Name>Class</Name>
      <Description>An empty class file</Description>
      <Icon>Class.ico</Icon>
      <ProjectType>CSharp</ProjectType>
      <ProjectSubType>Office</ProjectSubType>
      <DefaultName>Class.cs</DefaultName>
   </TemplateData>
   <TemplateContent>
      <ProjectItem>Class1.cs</ProjectItem>
   </TemplateContent>
</VSTemplate>

Criar manualmente um modelo de item

Em vez de usar o assistente, você pode criar um modelo de item manualmente a partir do zero.

  1. Crie um projeto e adicione um item.
  2. Modifique o item conforme desejado, como adicionar onde qualquer substituição de parâmetro deve ocorrer e salvar o item.
  3. Crie um arquivo XML e salve-o com uma extensão de arquivo .vstemplate no mesmo diretório que o arquivo de item do projeto.
  4. Adicione metadados de modelo de item ao arquivo XML .vstemplate , conforme mostrado no exemplo anterior. Para obter mais informações, consulte Referência de esquema de modelo (extensibilidade).
  5. Salve e feche o arquivo .vstemplate .
  6. No Windows Explorer, selecione os arquivos que você deseja incluir em seu modelo, incluindo o arquivo .vstemplate . Clique na seleção com o botão direito do mouse e selecione Compactar para>Arquivo ZIP.
  7. Copie o arquivo .zip resultante e cole-o na localização do modelo de item do usuário do Visual Studio. O diretório padrão é %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Conteúdo relacionado

  • Last updated on