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

Контекстные параметры

  • Статья

В интегрированной среде разработки Visual Studio можно добавлять мастера в диалоговое окно "Новый проект", "Добавить новый элемент" или "Добавить вложенный проект". Добавленные мастера доступны в меню "Файл" или щелкнув правой кнопкой мыши проект в Обозреватель решений. Интегрированная среда разработки передает параметры контекста в реализацию мастера. Параметры контекста определяют состояние проекта при вызове интегрированной среды разработки мастера.

Интегрированная среда разработки запускает мастеры, задав VSADDITEMOPERATION флаг в вызове интегрированной среды разработки для AddItem метода проекта. При установке проект должен привести IVsExtensibility::RunWizardFile к выполнению метода с помощью зарегистрированного имени мастера или GUID и других параметров контекста, передаваемых интегрированной среде разработки.

Параметры контекста для нового проекта

Параметр Описание
WizardType Зарегистрированный тип мастера (vsWizardNewProject) или GUID, указывающий тип мастера. В реализации пакета SDK Для Visual Studio для мастера используется идентификатор GUID {0F90E1D0-4999-11D1-B6D1-00A0C90F2744}.
ProjectName Строка, которая является уникальным именем проекта Visual Studio.
LocalDirectory Локальное расположение рабочих файлов проекта.
InstallationDirectory Путь к каталогу Visual Studio — установка.
FExclusive Логический флаг, указывающий, что проект должен закрыть открытые решения.
SolutionName Имя файла решения без части каталога или расширения SLN . Имя suo-файла также создается с помощью SolutionName. Если этот аргумент не является пустой строкой, мастер используется Create перед добавлением проекта в AddFromTemplate. Если это имя является пустой строкой, используйте AddFromTemplate без вызова Create.
Silent Логическое значение, указывающее, должен ли мастер выполняться автоматически, как если бы кнопку "Готово " (TRUE).

Параметры контекста для добавления нового элемента

Параметр Описание
WizardType Зарегистрированный тип мастера (vsWizardAddItem) или GUID, указывающий тип мастера. В реализации пакета SDK Visual Studio для мастера используется идентификатор GUID {0F90E1D1-4999-11D1-B6D1-00A0C90F2744}.
ProjectName Строка, которая является уникальным именем проекта Visual Studio.
ProjectItems Локальное расположение, содержащее рабочие файлы проекта.
ItemName Имя добавляемого элемента. Это имя файла по умолчанию или имя файла, которое типы пользователей в диалоговом окне "Добавление элементов ". Имя основано на флагах, заданных в VSDIR-файле . Имя может быть значением NULL.
InstallationDirectory Путь к каталогу Visual Studio — установка.
Silent Логическое значение, указывающее, должен ли мастер выполняться автоматически, как если бы кнопку "Готово " (TRUE).

Параметры контекста для добавления дочернего проекта

Параметр Описание
WizardType Зарегистрированный тип мастера (vsWizardAddSubProject) или GUID, указывающий тип мастера. В реализации пакета SDK Visual Studio guid для мастера — {0F90E1D2-4999-11D1-B6D1-00A0C90F2744}.
ProjectName Строка, которая является уникальным именем проекта Visual Studio.
ProjectItems Указатель на ProjectItems коллекцию, в которой работает мастер. Этот указатель передается мастеру на основе выбора иерархии проекта. Обычно пользователь выбирает папку, в которую нужно поместить элемент, а затем вызывает диалоговое окно добавления элемента проекта.
LocalDirectory Локальное расположение рабочих файлов проекта.
ItemName Имя добавляемого элемента. Это имя файла по умолчанию или имя файла, которое типы пользователей в диалоговом окне "Добавление элементов ". Имя основано на флагах, заданных в VSDIR-файле . Имя может быть значением NULL.
InstallationDirectory Путь к каталогу установки Visual Studio.
Silent Логическое значение, указывающее, должен ли мастер выполняться автоматически, как если бы кнопку "Готово " (TRUE).

См. также