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

Статья
08/11/2011

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

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

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

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

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

\каталог_установки_Visual_Studio\Common7\IDE\ItemTemplates\язык\языковой_стандарт\.
\каталог_установки_Visual_Studio\Common7\IDE\ProjectTemplates\язык\языковой_стандарт\.

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

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

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

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

\My Documents\Visual Studio 2010\Templates\ProjectTemplates\язык\.
\My Documents\Visual Studio 2010\Templates\ItemTemplates\язык\.

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

C:\Documents and Settings\UserName\My Documents\Visual Studio 2010\Templates\ProjectTemplates\Visual C#\.

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

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

\My Documents\Visual Studio 2010\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-файл.