Поделиться через

Создание шаблонов элементов

В этой статье показано, как создать шаблон элемента с помощью мастера экспорта шаблонов или вручную, а также как редактировать и использовать шаблоны элементов. Если шаблон состоит из нескольких файлов, см . раздел Как создать шаблоны элементов с несколькими файлами.

Добавление шаблона элемента

  1. Создание или открытие проекта в Visual Studio.

  2. Выберите Проект>Добавить новый элемент или нажмите Ctrl+Shift+A.

  3. В диалоговом окне «Добавить новый элемент » выберите элемент, а затем нажмите кнопку «Добавить », чтобы добавить его в проект.

  4. Измените элемент по своему усмотрению и укажите, где в элементе, если вообще где-либо, должна произойти замена параметров. Дополнительные сведения см. в разделе "Практическое руководство. Замена параметров в шаблоне".

  5. Сохраните товар.

  6. ВыберитеШаблон экспортапроекта>. Открывается Мастер шаблонов экспорта.

  7. На странице Выбор типа шаблона выберите Шаблон элемента, выберите проект, содержащий элемент, а затем нажмите кнопку Далее.

  8. На странице "Выбор элемента для экспорта " выберите элемент, для которого требуется создать шаблон, а затем нажмите кнопку "Далее".

  9. На странице " Выбор ссылок на элементы " выберите все ссылки на сборки для включения в шаблон, а затем нажмите кнопку "Далее".

  10. На странице "Выбор параметров шаблона ":

    • Введите имя шаблона и необязательное описание, изображение значка и изображение для предварительного просмотра.

      Файлы значков для элементов — это .ico файлы, как описано в разделе Изображения и значки для Visual Studio. Изображение предварительного просмотра — это изображение размером 200 x 200, которое отображается в диалоговом окне «Добавить новый элемент ». Вы можете скачать библиотеку изображений Visual Studio , чтобы получить значки, соответствующие стилю Visual Studio.

    • Выберите, следует ли автоматически импортировать шаблон в Visual Studio и отображать окно проводника в папке выходных файлов.

  11. Нажмите Готово.

Файлы шаблонов сжимаются в файл .zip и копируются в каталог, указанный в мастере в разделе Место вывода. По умолчанию используется %USERPROFILE%\Документы\Версия> Visual Studio<\Мои экспортированные шаблоны.

Если выбран параметр Автоматически импортировать шаблон в Visual Studio, файл .zip также добавляется в пользовательский каталог ItemTemplates . По умолчанию используется %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Теперь вы можете использовать шаблон элемента в своих проектах.

Использование шаблона элемента

  1. Если при создании шаблона вы не выбрали параметр Автоматически импортировать шаблон в Visual Studio , скопируйте файл .zip в каталог ItemTemplates . По умолчанию используется %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.
  2. Закройте Visual Studio, а затем снова откройте ее.
  3. Создайте новый проект или откройте существующий проект и выберитеДобавить новый элементв проект>
  4. Выберите шаблон элемента в диалоговом окне Добавить новый элемент . Если вы добавили описание в мастере экспорта шаблонов, оно появится в правой части диалогового окна.
  5. Нажмите кнопку Добавить , чтобы добавить элемент шаблона в проект.

Редактирование файла .vstemplate

Мастер создает базовый шаблон, но в некоторых случаях необходимо вручную изменить файл .vstemplate после экспорта шаблона. Например, если вы хотите, чтобы элемент отображался в диалоговом окне " Добавить новый элемент " для проекта универсального приложения для Windows, необходимо отредактировать файл .vstemplate .

  1. Извлеките экспортированный шаблон элемента .zip файл и откройте файл .vstemplate в Visual Studio.
  2. При необходимости отредактируйте файл. Для проекта C# Universal Windows добавьте <TemplateID>Microsoft.CSharp.Class</TemplateID> внутри <TemplateData> элемента.
  3. Сохраните и закройте файл .vstemplate , а затем замените его в файле .zip .

Включение шаблонов для определенных подтипов проектов

Вы можете изменить файл .vstemplate , указав, что шаблон элемента отображается только для определенных подтипов проектов, таких как Windows, Office, база данных или Интернет.

  1. Откройте файл .vstemplate для редактирования.
  2. Добавьте элемент ProjectSubType сразу после элемента со значением ProjectTypeWindows, Office, Database, или Web. Например: <ProjectSubType>Database</ProjectSubType>.

В следующем примере показан файл .vstemplate для Office проектов.

<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>

Создание шаблона элемента вручную

Вместо использования мастера вы можете создать шаблон элемента вручную с нуля.

  1. Создайте проект и добавьте элемент.
  2. Измените элемент по своему усмотрению, например, добавив место, где должна произойти замена параметров, и сохраните элемент.
  3. Создайте XML-файл и сохраните его с расширением .vstemplate в том же каталоге, что и файл элемента проекта.
  4. Добавьте метаданные шаблона элемента в XML-файл VSTEMPLATE , как показано в предыдущем примере. Дополнительные сведения см. в разделе Справочник по схеме шаблона (расширяемость).
  5. Сохраните и закройте файл .vstemplate .
  6. В проводнике Windows выберите файлы, которые вы хотите включить в шаблон, включая файл .vstemplate . Щелкните правой кнопкой мыши на выделение и выберите Сжать в>ZIP-файл.
  7. Скопируйте полученный файл.zip и вставьте его в папку шаблона пользовательского элемента Visual Studio. По умолчанию используется каталог %USERPROFILE%\Documents\Visual Studio <version>\Templates\ItemTemplates.

Связанный контент