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

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

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

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

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

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

<VisualStudioInstallDir>\Common7\IDE\ItemTemplates\Language\Locale\
<VisualStudioInstallDir>\Common7\IDE\ProjectTemplates\Language\Locale\

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

C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\ItemTemplates\VisualBasic\1033\

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

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

My Documents\Visual Studio 2008\Templates\ProjectTemplates\Language\
My Documents\Visual Studio 2008\Templates\ItemTemplates\Language\

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

C:\Documents and Settings\Имя_пользователя\My Documents\Visual Studio 2008\ProjectTemplates\Visual C# \

Пользовательские шаблоны не включают подкаталог для локализованных шаблонов. Можно изменить каталог по умолчанию для пользовательских шаблонов в окне диалогового окна Параметры. Дополнительные сведения см. в разделе "Общие", страница "Проекты и решения", диалоговое окно "Параметры".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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