объект конфигурации проекта
Объект конфигурации проекта управляет отображением сведений о конфигурации на пользовательский интерфейс.
Страницы свойств конфигурации проекта
.gif "Конфигурация проекта Visual Studio")
Поставщик конфигурации проекта управляет конфигурации проекта. Среда и другие пакеты, получить доступ и получить сведения о конфигурациях проекта, вызывающие интерфейсы вложенно к объекту поставщика конфигурации проекта.
Примечание
Интерфейсы VSIP для создания конфигурации решения программным образом.Нет api-интерфейса VSIP для редактирования конфигурации решения.Необходимо использовать DTE.SolutionBuilder.Дополнительные сведения см. в разделах конфигурация решения и модель автоматизации.
Чтобы опубликовать отображаемое имя, используемое в пользовательском интерфейсе конфигурации, проект должен реализовать get_DisplayName. Вызовы среды GetCfgs, которую возвращает список IVsCfg указатели, которые можно использовать, чтобы получить отображаемые имена для данных о конфигурации и платформы, которые необходимо перечислить в пользовательском интерфейсе среды. Активные конфигурации и платформы определяются конфигурацией проекта, хранящиеся в активной конфигурации решения. FindActiveProjectCfg метод можно использовать для получения конфигурация активного проекта.
IVsProjectCfgProvider можно реализовать на объект IVsCfgProvider2 объект с IVsCfgProviderEventsHelper объект, который требуется позволяя извлекать IVsProjectCfg2 объект на основе каноническом имя конфигурации проекта.
Другой способ защитить среду и другие проекты с доступом к конфигурациям проекта для проектов предоставить реализацию IVsCfgProvider2::GetCfgs метод, для которого следует возвратить один или несколько объектов конфигурации. Проекты могут также реализовать IVsProjectCfg2, от которого наследует IVsProjectCfg и, таким образом, из IVsCfgдля предоставления сведений о конфигурация-специфического. IVsCfgProvider2 поддерживает платформы и функциональность добавление, удаление и переименование конфигурации проекта.
Примечание
Поскольку Visual Studio уже не ограничивается 2 типа конфигурации, код, что конфигурации процесса не должны быть написаны с допущениями о количестве конфигурации, и он должен быть записан с предположением, что проект, который содержит только одну конфигурацию обязательно или debug или retail.Это делает использование get_IsReleaseOnly и get_IsDebugOnly устарел.
Вызов QueryInterface в объекте, возвращенном изIVsGetCfgProvider::GetCfgProvider извлекает IVsCfgProvider2. If IVsGetCfgProvider не найдены путем вызова QueryInterface на IVsProject3 объект проекта можно получить доступ к объекту поставщика конфигурации путем вызова QueryInterface в объекте браузера для объекта, возвращаемого для корня иерархии IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_BrowseObject)или через указатель на поставщик конфигурации для возвращенных IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_ConfigurationProvider).
IVsProjectCfg2 в основном предоставляет доступ для построения, развертывания и отладки и объекты управления позволяет проектам lib группирования выходов. Методы IVsProjectCfg и IVsProjectCfg2 может использоваться для реализации IVsBuildableProjectCfg управление процессом построения. IVsOutputGroup указатели для групп в составе вывода конфигурация.
Проект должен возвращать одинаковое количество групп для каждой конфигурации, которую он поддерживает даже если число выходов, содержащихся в пределах группы может отличаться от конфигурации в конфигурации. Группы также должны иметь одни и те же данные идентификатора (каноническое имя, отображаемое имя, и данные группы) из конфигурации в конфигурации проекта. Дополнительные сведения см. в разделе Конфигурация проекта для вывода.
Чтобы включить отладку, конфигурации, должны реализовывать IVsDebuggableProjectCfg. IVsDebuggableProjectCfg необязательный интерфейс, реализованный проектами разрешить отладчик, чтобы запустить конфигурацию и реализуется для объекта конфигурации с IVsCfg и IVsProjectCfg. Среда вызывает его, когда пользователь избирает для запуска отладчика, нажав клавишу F5.
ISpecifyPropertyPages и IDispatch используйте совместно с помощью страниц свойств для извлечения и отображения данных по конфигурация-зависимой ячейки для пользователя. Дополнительные сведения см. в разделе Страницы свойств.
См. также
Основные понятия
Конфигурация проекта для построения
Конфигурация проекта для вывода