Практическое руководство. Добавление ссылок в шаблоны

Статья
11/05/2008

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

Эта процедура предназначена для создания шаблонов, содержащих ссылки на сборку.

Добавление ссылок в шаблоны проектов

Шаблоны проектов всегда включают файл проекта, который предоставляет способ добавления или удаления ссылок в шаблоне.

Для добавления ссылок в шаблоны проектов

В меню Файл выберите Создать и выберите Проект.
В диалоговом окне Новый проект выберите шаблон, который требуется обновить, укажите имя и расположение проекта и нажмите кнопку ОК.
Добавьте в проект или удалите ссылки с помощью диалогового окна Добавить ссылку. Дополнительные сведения о добавлении ссылок см. в разделе Практическое руководство. Добавление или удаление ссылок в Visual Studio (Visual Basic).
Для создания нового шаблона воспользуйтесь мастером Экспорт шаблона. Дополнительные сведения см. в разделе Практическое руководство. Создание начальных наборов.
После того как обновленный шаблон будет сохранен в ZIP-файл, удалите старый ZIP-файл шаблона.

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

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

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

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

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

Создайте или откройте проект в Visual Studio.
Добавьте элемент к проекту и измените его при необходимости.
В меню Файл выберите команду Экспорт шаблона.
Щелкните Шаблон элемента, выберите проект, содержащий элемент и нажмите кнопку Далее.
Выберите элемент для создания шаблона и нажмите кнопку Далее.

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

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

Введите имя файла значка, имя шаблона и описание шаблона и нажмите кнопку Готово.
Если существующий шаблон был изменен, то удалите старый ZIP-файл шаблона.

Кроме того, можно вручную отредактировать файл с расширением VSTEMPLATE, чтобы добавить ссылки на шаблон элемент.

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

Найдите файл с расширением ZIP, содержащий шаблон.
Извлеките ZIP-файл.
Откройте файл .vstemplate в Visual Studio.
В элементе TemplateContent добавьте элемент References.
В элементе References добавьте один или несколько элементов Reference для хранения сборок для ссылки.

В каждом элементе Reference добавьте элемент Assembly со сборкой для ссылки. Например:

<TemplateContent>
    <References>
        <Reference>
            <Assembly>
                System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
            </Assembly>
        </Reference>
        <Reference>
            <Assembly>
                System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
            </Assembly>
        </Reference>
    </References>
    ...
</TemplateContent>

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

Сохраните и закройте файл .vstemplate.
Выберите файлы, включенные в шаблон, щелкните правой кнопкой мыши, выберите пункт Отправить и щелкните Сжатая ZIP-папка. Выбранные файлы будут сжаты в ZIP-файл.
Удалите извлеченные файлы шаблона и старый ZIP-файл шаблона.
Поместите новый ZIP-файл в тот же каталог, где был удаленный ZIP-файл.