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


Настраиваемые параметры

Пользовательские параметры управляют операцией мастера после запуска мастера. Связанный VSZ-файл предоставляет массив определяемых пользователем параметров, которые упаковываются интегрированной средой разработки (IDE) и передаются мастеру в виде массива строк при запуске мастера. Затем мастер анализирует массив строк и использует сведения для управления фактической операцией мастера. Таким образом мастер может настраивать функциональные возможности в зависимости от содержимого VSZ-файла .

С другой стороны, параметры контекста определяют состояние проекта при запуске мастера. Дополнительные сведения см. в разделе "Параметры контекста".

Ниже приведен пример VSZ-файла с пользовательскими параметрами:

VSWIZARD 8.0
Wizard=VsWizard.VsWizard_Engine
Param="WIZARD_NAME = Sample Wizard"
Param="WIZARD_UI = FALSE"
Param="RELATIVE_PATH = VSWizards\Classwiz\ATL"
Param="PREPROCESS_FUNCTION = CanAddATLSupport"
Param="PROJECT_TYPE = CSPROJ"

Автор VSZ-файла добавляет значения параметров. Когда пользователь выбирает новый проект или добавляет новый элемент в меню "Файл" или щелкнув правой кнопкой мыши проект в Обозреватель решений, интегрированная среда разработки собирает эти значения в массив строк. Затем интегрированная среда разработки вызывает метод проекта AddItem с VSADDITEMOPERATION набором флагов, а проект вызывает RunWizardFile метод, который отвечает за запуск мастера и возврат результата.

Мастер отвечает за синтаксический анализ массива строк и правильное действие над строками. Таким образом, реализуя настраиваемые параметры, можно создать один мастер, который выполняет различные функции. Другими словами, один мастер может иметь три разных VSZ-файла . Каждый файл передает различные наборы пользовательских параметров для управления поведением мастера в различных ситуациях.

Дополнительные сведения см. в файле мастера (VSZ).