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


Настройка VSZ-файлов для запуска мастеров

Надстройки Visual Studio выступан сопоставления в Visual Studio 2013. Необходимо обновить для надстройки с расширениями VSPackage. Дополнительные сведения об обновлении см. в разделе Часто задаваемые вопросы. Преобразование надстроек в расширения VSPackage.

Visual Studio для запуска мастеров использует тип файлов VSZ. Это текстовые файлы с расширением VSZ, используемые Visual Studio для определения того, какой мастер следует вызвать, и какие данные при необходимости следует ему передать.

Сравнение с INI-файлом

VSZ-файл является упрощенной версией текстового файла формата INI, но не содержит помеченных разделов. В первой части хранятся сведения, известные среде Visual Studio. Второй раздел позволяет среде собирать и передавать мастеру специфичные для него параметры.

Ниже приведен образец файла VSZ.

VSWizard 8.0
Wizard=VIDWizard.CBlankSiteWizard
Param=<item1>
Param=<item2>
…

Примечание

Значение мастера может также представлять собой GUID в формате {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}, т. е. состоящий из фрагментов длиной 8, 4, 4, 4 и 12 символов.

Этот файл состоит из следующих частей:

  • VSWizard — номер версии формата файла шаблона; для Visual Studio равняется VSWizard 8.0. Другие числа не допускаются, и их использование приведет к возникновению ошибки "Недопустимый формат".

  • Wizard — Это программный идентификатор (ProgID), такой как MyWizard.MyClass, или строковое представление GUID для CLSID мастера, который также будет параллельно создан Visual Studio.

  • Param — Эти параметры необязательны и их можно добавить столько, сколько требуется для разрабатываемого мастера. Их использование позволяет файлу VSZ передавать мастеру дополнительные пользовательские параметры. Каждое значение передается мастеру как строковый элемент в массиве.

См. также

Задачи

Практическое руководство. Создание надстройки

Пошаговое руководство. Создание мастера

Основные понятия

Добавление мастеров в диалоговые окна "Добавить элемент" и "Создать проект" при помощи файлов VSDIR

Другие ресурсы

Создание надстроек и мастеров