关于Configuration Manager控制台窗体

可以使用新的 Windows 窗体扩展Configuration Manager控制台。 具体而言,可以添加基于窗体的对话框和属性表。 用户从你定义的Configuration Manager操作访问这些表单。

注意

向导是 Configuration Manager 控制台使用的另一个 Windows 窗体,但不能通过使用 Configuration Manager 控制台框架来扩展或添加向导。 但是,可以使用Configuration Manager操作运行自己的向导解决方案。

在Configuration Manager中,窗体存储在.NET Framework程序集中,Configuration Manager控制台在选择适当的操作后调用这些程序集。

创建扩展窗体

若要编写扩展窗体,请执行以下操作:

  • 创建扩展窗体程序集。

  • 创建扩展窗体操作 XML。

  • 创建扩展表单 XML。

创建扩展窗体程序集

属性表

属性表由定义的一个或多个属性页组成。 还可以将属性页集成到现有Configuration Manager属性表。

若要创建属性表,请在 Visual Studio 中创建 Windows 控件库项目。 在此项目中,将创建继承自 Microsoft 的类。ConfigurationManagement.AdminConsole.SmsPageControl 类。 此类实现要在属性页上显示的控件。 在属性表中,为所需的每个属性页创建 SmsPageControl 类。 Configuration Manager SDK 中的属性表原型示例提供了一个可以使用的完整解决方案。 有关详细信息,请参阅如何创建Configuration Manager属性表

对话框

Configuration Manager中的对话框显示为典型的无模式对话框。 创建 SMSPageControl 并在表单 XML 中指定“Dialog”。 有关详细信息,请参阅如何创建Configuration Manager对话框

创建表单操作 XML

操作描述调用的扩展类型,以及操作在Configuration Manager控制台用户界面中的位置。 对于扩展窗体,可以使用 ShowDialog 操作类型来显示窗体。 有关详细信息,请参阅如何为Configuration Manager属性表创建操作 XML

有关操作的详细信息,请参阅关于Configuration Manager控制台操作

创建表单属性表 XML

无论窗体是否为属性表,窗体都有一个定义窗体程序集、命名空间和窗体类型的表单 XML 文件。 在属性表中,它定义属性表上属性页的顺序。 每个Configuration Manager控制台窗体都有一个属性表 XML 文件。

注意

Configuration Manager控制台属性表 XML 文件存储在 %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Forms 中。

创建新窗体时,将创建新的属性表 XML 文件。 如果要向现有属性表添加新的属性页,请将属性页 XML 与现有属性表 XML 文件合并。

注意

扩展属性表存储在 %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms 中。

有关表单 XML 部署的详细信息,请参阅 Configuration Manager控制台扩展部署

根据显示的是对话框还是属性表,必须设置 FormType 属性值。

FormType 说明
PropertySheet 窗体是属性表。
对话框 窗体是一个对话框。

选择某个操作后,Configuration Manager控制台使用属性表 XML 来确定加载和显示窗体所需的程序集。

有关详细信息,请参阅如何为Configuration Manager属性表创建表单 XML

管理窗体中的对象数据

Configuration Manager窗体可以传递自定义数据,还可以从结果窗格中传递从查询返回的对象。 结果窗格中的选定对象通过 PropertyManager 对象提供给窗体。 有关详细信息,请参阅如何使用传递给 Configuration Manager 窗体的对象。 可以将窗体控件绑定到传入到窗体的 PropertyManager的对象。 有关详细信息,请参阅如何将Configuration Manager数据绑定到窗体

Configuration Manager控制台在关闭窗体时序列化传递到窗体中的Configuration Manager对象。

查询

可以使用托管 SMS 提供程序在表单中执行同步和异步查询。 你得到Microsoft。窗体的 ConnectionManager 中的 ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor 对象。PropertyManager 获取代码后,代码与 SMS 提供程序示例相同。 有关同步查询的示例,请参阅如何使用托管代码执行同步Configuration Manager查询

有关异步查询的示例,请参阅如何使用托管代码执行异步Configuration Manager查询

另请参阅

如何将属性页添加到现有Configuration Manager属性表
如何将Configuration Manager数据绑定到窗体
如何创建Configuration Manager属性表
如何为Configuration Manager对话框创建操作 XML
如何为Configuration Manager属性表创建操作 XML
如何创建Configuration Manager对话框
如何为“Configuration Manager”对话框创建表单 XML
如何为Configuration Manager属性表创建表单 XML
如何使用传递给Configuration Manager窗体的对象