Практическое руководство. Размещение и упорядочение шаблонов проектов и элементов

Статья
06/10/2015

Файлы шаблона должны быть помещены в месте, которое Visual Studio распознает для отображения шаблонов в диалоговых окнах Создать проект и Добавление нового элемента.Можно создать пользовательские подкатегории шаблонов так, чтобы они отображались в пользовательском интерфейсе.

Расположение шаблонов

По умолчанию Visual Studio проверяет два расположения шаблонов проектов и элементов.Если сжатый файл, содержащий файл с расширением VSTEMPLATE, находится в этих расположениях, шаблон будет отображаться в диалоговых окнах Создать проект или Добавление нового элемента.

Установленные шаблоны

По умолчанию установленные вместе с продуктом шаблоны находятся в следующих папках.

\Locale\VisualStudioInstallationDirectory\Common7\IDE\ItemTemplates\Language\
\Locale\VisualStudioInstallationDirectory\Common7\IDE\ProjectTemplates\Language\

Например, следующий каталог содержит шаблоны проектов Visual Studio для английского языка.

C: \VisualStudioInstallationDirectory\Common7\IDE\ItemTemplates\VisualBasic\1033\

Пользовательские шаблоны

По умолчанию пользовательские шаблоны расположены в следующих папках.

\My \Language\Templates\ProjectTemplates\ Version приложение Documents\Visual
\My \Language\Templates\ItemTemplates\ Version приложение Documents\Visual

Например, следующий каталог содержит пользовательские шаблоны проектов Visual C#:

C: \Documents и Settings\UserName\My Documents\Visual Studio 2013\Templates\ProjectTemplates\Visual C#\

Пользовательские шаблоны не включают подкаталог для локализованных шаблонов.Можно изменить каталог по умолчанию для пользовательских шаблонов в диалоговом окне Параметры в поле Environment\Projects и решения.

Упорядочение шаблонов

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

Примечание
Невозможно создать новую категорию на уровне языка программирования.Новые категории могут создаваться только в пределах каждого языка.

Если каталоги для установленных и пользовательских шаблонов для определенного языка не имеют одной и той же структуры (то есть существуют директории в одной папке, которые не существуют в другой), то набор категорий, отображаемых в диалоговом окне Новый проект будет слиянием из всех категорий.

Упорядочение установленных шаблонов

Можно упорядочить установленные шаблоны путем создания подкаталогов в папке языка программирования.Эти подкаталоги отображаются в виде виртуальных папок в диалоговых окнах Создать проект и Добавление нового элемента в пределах каждого языка.

Чтобы создать новые категории установленного шаблона проекта

Создайте папку в папке языка в каталоге установленного шаблона.Например чтобы создать категорию Office для шаблонов проектов Visual Studio, надо создать следующий каталог:

\VisualStudioInstallationDirectory\Common7\IDE\ProjectTemplates\VisualBasic\1033\Office\
Поместите все шаблоны для этой категории в новую папку.
Закройте все экземпляры Visual Studio.
В меню Пуск выберите Выполнить, введите cmd и нажмите кнопку ОК.
В командной строке найдите каталог, содержащий файл devenv.exe, и введите devenv /installvstemplates.
Запустите Visual Studio.
В меню Файл последовательно выберите пункты Создать и Проект.
Убедитесь, что категория Office появилась в диалоговом окне Создать проект области Типы проектов в Visual Basic.

Также можно сгруппировать подмножество шаблонов элементов проекта в пользовательскую папку.

Чтобы создать новые категории установленного шаблона элемента

Создайте папку в папке языка в каталоге установленного шаблона.Например, чтобы создать веб-категории для шаблонов элементов Visual C#, необходимо создать следующий каталог:

\VisualStudioInstallationDirectory\Common7\IDE\ItemTemplates\CSharp\1033\Web\
Поместите все шаблоны для этой категории в новую папку.
Закройте все экземпляры Visual Studio.
В меню Пуск выберите Выполнить, введите cmd и нажмите кнопку ОК.
В командной строке найдите каталог, содержащий файл devenv.exe, и введите devenv /setup.
Запустите Visual Studio.
Создайте проект или откройте существующий проект.
В меню Проект выберите команду Добавить новый элемент.
Убедитесь, что веб-категория появилась в диалоговом окне Добавление нового элемента области Типы проектов.

Упорядочение пользовательских шаблонов

Пользовательские шаблоны могут быть упорядочены в своей собственной категории добавлением новых папок в каталог расположения шаблона.Диалоговое окно Новый проект отражает любые изменения категорий шаблонов.

Для создания новых категорий пользовательского шаблона проекта

Создайте папку в папке языка в каталоге пользовательского шаблона проекта.Например, чтобы создать категорию HelloWorld для шаблонов Visual C#, необходимо создать следующий каталог.

\My \Templates\ProjectTemplates\CSharp\HelloWorld\ Documents\Visual Studio 2013
Поместите все шаблоны для этой категории в новую папку.
В меню Файл последовательно выберите пункты Создать и Проект.
Убедитесь, что категория HelloWorld появилась в диалоговом окне Создать проект области Типы проектов в Visual C#.

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

Для создания новых категорий пользовательского шаблона элемента

Создайте папку в папке языка в каталоге пользовательского шаблона элемента.Например, чтобы создать категорию HelloWorld для шаблонов Visual C#, необходимо создать следующий каталог:

\My \Templates\ItemTemplates\CSharp\HelloWorld\ Documents\Visual Studio 2013
Поместите все шаблоны для этой категории в новую папку.
Создайте проект или откройте существующий проект.
В меню Проект выберите команду Добавить новый элемент.
Убедитесь, что категория HelloWorld появилась в диалоговом окне Добавление нового элемента области Типы проектов.

Отображение шаблонов в родительских категориях

Можно разрешить отображение шаблонов в подкатегориях в их родительской категории с помощью элемента NumberOfParentCategoriesToRollUp в файле с расширением VSTEMPLATE.Эта процедура идентична для шаблонов проектов и элементов.

Чтобы отобразить шаблоны в родительских категориях

Найдите файл с расширением ZIP, содержащий шаблон.
Извлеките ZIP-файл.
Откройте файл .vstemplate в Visual Studio.
В элементе TemplateData добавьте элемент NumberOfParentCategoriesToRollUp.Например, следующий код делает шаблон видимым в родительской категории, но не выше нее.
```
<TemplateData>
    ...
    <NumberOfParentCategoriesToRollUp>
        1
    </NumberOfParentCategoriesToRollUp>
    ...
</TemplateData>
```
Сохраните и закройте файл .vstemplate.
Выберите файлы в шаблоне, щелкните выделение правой кнопкой мыши, выберите Отправить и щелкните Сжатая ZIP-папка.Файлы упакуются в ZIP-файл.
Удалите извлеченные файлы шаблона и старый ZIP-файл шаблона.
Поместите новый ZIP-файл в каталог, где был удаленный ZIP-файл.

См. также

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