Partilhar via

Criar modelos de item

Este artigo mostra como criar um modelo de item usando o Assistente para Exportar Modelo 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 item de vários arquivos.

Adicionar um modelo de item

  1. Crie ou abra um projeto no Visual Studio.

  2. Selecione Projeto>Adicionar Novo Item ou pressione Ctrl+Shift+A.

  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 houver, a substituição de parâmetros deve ocorrer. Para obter mais informações, consulte Como substituir parâmetros em um modelo.

  5. Salve o item.

  6. SelecioneModelo de exportação de projeto>. O Assistente para Exportação de Modelo é 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 a Exportar , escolha o item para o qual pretende criar um modelo e, em seguida, selecione Seguinte.

  9. Na página Selecionar Referências de Item , selecione quaisquer 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.

      Os arquivos de ícone para itens são arquivos .ico , conforme descrito em Imagens e ícones para Visual Studio. A imagem de visualização é uma imagem de 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 deseja importar automaticamente o modelo 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 em 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.

Utilize o modelo de item

  1. Se você não selecionou Importar automaticamente o modelo para o Visual Studio quando criou 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 abra-o novamente.
  3. Crie um novo projeto ou abra um projeto existente e selecione Projeto>Adicionar Novo Item
  4. Selecione o modelo de item na caixa de diálogo Adicionar Novo Item . Se você adicionou uma descrição no Assistente para Exportação de Modelo, a descrição aparecerá 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 desejar que o item apareça na caixa de diálogo Adicionar Novo Item para um projeto de 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 C# Universal do Windows, 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 seu modelo de item apareça 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 elemento ProjectType, com o valor de Windows, Office, Database, ou 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, pode-se criar um modelo de item manualmente desde o início.

  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 salve 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 de 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 Explorador do Windows, selecione os ficheiros que pretende incluir no seu modelo, incluindo o ficheiro .vstemplate . Clique com o botão direito do mouse na seleção e selecione Compactar para>arquivo ZIP.
  7. Copie o arquivo .zip resultante e cole-o no local do modelo de item de usuário do Visual Studio. O diretório padrão é %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Conteúdo relacionado

  • Last updated on