项目配置对象管理配置信息显示为 UI。
项目配置属性页
项目配置提供程序管理项目配置。 该环境和其他包,获取对和检索有关项目配置的信息,调用接口附加项目配置提供程序对象。
若要公布用于该配置的显示名称 UI,该项目应实现 get_DisplayName。 环境调用 GetCfgs,返回 IVsCfg 指针列出了可用于获取显示名称。在环境的 UI 中列出的配置和平台信息。 在活动解决方案配置存储区的项目配置取决于活动配置和平台。 FindActiveProjectCfg 方法可用于检索事件项目配置。
IVsProjectCfgProvider 对象在 IVsCfgProvider2 对象可以选择将实现。 IVsCfgProviderEventsHelper 对象可以检索基于规范项目配置名称的 IVsProjectCfg2 对象。
另一种提供该环境和其他项提供对项目配置的访问是为了项目中提供 IVsCfgProvider2::GetCfgs 方法的实现返回一个或多个配置对象。 项还可实现 IVsProjectCfg2,继承 IVsProjectCfg 从而从 IVsCfg,提供特定于配置的信息。 IVsCfgProvider2 支持平台和功能添加,删除和给定的项目配置重命名。
备注
因为 Visual Studio 不再局限于两种配置类型,进程配置的代码不应应编写的有关配置数的假设,也不编写,假定只有一个配置的项目需要调试或发布。这使得使用过时的 get_IsReleaseOnly 和的 get_IsDebugOnly 。
调用从IVsGetCfgProvider::GetCfgProvider 返回的对象的 QueryInterface 检索 IVsCfgProvider2。 如果调用 IVsProject3 项对象的 QueryInterface 未找到 IVsGetCfgProvider ,可以配置提供程序对象通过调用层次结构的根浏览器对象的 QueryInterface 对象的 IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_BrowseObject)返回的访问权限,或者传递到该配置的指针提供程序 IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_ConfigurationProvider)返回。
IVsProjectCfg2 主要提供对生成,调试和部署管理对象并提供项目任意分组输出。 IVsProjectCfg 和 IVsProjectCfg2 方法可用于实现 IVsBuildableProjectCfg 管理生成过程和配置的输出组的 IVsOutputGroup 指针。
该项目必须返回组个数与它所支持的每个配置中,即使在组中包含的输出的数量可以从配置更改到配置。 组还必须具有相同标识符信息 (规范名称、显示名称和组信息) 从配置为在项目中配置。 有关更多信息,请参见 输出的项目配置。
若要启用调试,配置应实现 IVsDebuggableProjectCfg。 IVsDebuggableProjectCfg 为项目实现的可选接口允许调试器生成配置和实现与 IVsCfg 和 IVsProjectCfg的配置对象。 该环境调用它,当用户决定按 F5 启动调试器时。
ISpecifyPropertyPages 和 IDispatch 使用属性页结合使用来检索并显示配置相关信息传递给用户。 有关更多信息,请参见 属性页。