This example demonstrates how you can add a custom data-bound (data-aware) control to a View and display this View from the navigation in a WinForms XAF application. For demo purposes, in this example you will add the GridControl control with the CardView to the EFDemo application (installed to %PUBLIC%\Documents\DevExpress Demos 19.2\Components\eXpressApp Framework\EFDemoCodeFirst by default). However, you can use the same approach with any other custom control in your own XAF application.
此示例演示如何将自定义数据绑定（数据感知）控件添加到视图，并从 WinForms XAF 应用程序中的导航中显示此视图。出于演示目的，在此示例中，您将使用 CardView 将 GridControl 控件添加到 EFDemo 应用程序（默认情况下安装到 %PUBLIC%_文档_DevExpress 演示 19.2_组件eXpressApp 框架_EFDemoCodeFirst）。但是，您可以在自己的 XAF 应用程序中对任何其他自定义控件使用相同的方法。
Create a User Control
创建用户控件
In the WinForms module project, create a User Control. Right-click the project and choose Add | User Control...
在 WinForms 模块项目中，创建用户控件。右键单击项目并选择"添加 |用户控制...
Add the required control, e.g., GridControl from the Toolbox to the designer.
将所需的控件（例如，从工具箱中的 GridControl 添加到设计器）。
Customize the control as required; e.g., convert the GridControl.MainView to CardView.
根据需要自定义控件;例如，将网格控制.MainView 转换为卡视图。
Bind the Control to Data Using Object Space
使用对象空间将控件绑定到数据
Close the designer, right-click the UserControl1.cs (UserControl1.vb) file and choose View Code to edit the User Control code. Implement the IComplexControl interface. In the IComplexControl.Setup method, you can access the Object Space using the objectSpace parameter, use the Object Space API to read the required data and then initialize the control's data source. In the IComplexControl.Refresh method (that is executed when a user clicks the Refresh Action), you can recreate the control's data source. The code below demonstrates the collection of DemoTask objects assigned to the GridControl.DataSource property.
关闭设计器，右键单击UserControl1.cs （UserControl1.vb） 文件，然后选择"查看代码"以编辑用户控制代码。实现 I复杂控制接口。在 IComplexControl.setup 方法中，可以使用对象空间参数访问对象空间，使用对象空间 API 读取所需的数据，然后初始化控件的数据源。在 IComplexControl.Refresh 方法（当用户单击刷新操作时执行）中，可以重新创建控件的数据源。下面的代码演示了分配给 GridControl.DataSource 属性的 DemoTask 对象的集合。
using DevExpress.ExpressApp; using DevExpress.ExpressApp.Editors; // ... public partial class UserControl1 : UserControl, IComplexControl { public UserControl1() { InitializeComponent(); } private IObjectSpace objectSpace; void IComplexControl.Setup(IObjectSpace objectSpace, XafApplication application) { gridControl1.DataSource = objectSpace.GetObjects<EFDemo.Module.Data.DemoTask>(); this.objectSpace = objectSpace; } void IComplexControl.Refresh() { gridControl1.DataSource = objectSpace.GetObjects<EFDemo.Module.Data.DemoTask>(); } }
Add a ControlViewItem View Item to a View
将控件视图项视图项添加到视图
In the WinForms module project, double-click the Model.DesignedDiffs.xafml file to start the Model Editor. Right-click the Views node and choose Add | DashboardView.
在 WinForms 模块项目中，双击"模型.设计Diffs.xafml"文件以启动模型编辑器。右键单击"视图"节点并选择"添加 |仪表板视图。
Set the Id property to TaskCardView.
将 Id 属性设置为任务卡视图。
Right-click the Views | TaskCardView | Items node and choose Add... | ControlDetailItem.
右键单击视图 |任务卡视图 |项目节点并选择"添加..." |控件详细信息Item。
Set the Id property to TaskCardView, and the IModelControlDetailItem.ControlTypeName property - to the type of the custom User Control you created (e.g., EFDemo.Module.Win.UserControl1).
将 Id 属性设置为 TaskCardView，将 IModelControl 详细信息项目.ControlTypeName 属性设置为您创建的自定义用户控件的类型（例如，EFDemo.Module.Win.UserControl1）。
Focus the Layout node. Right click the designer surface to the right and choose Customize Layout. Then, right-click the TaskCardView layout item and choose Hide Text.
聚焦布局节点。右键单击右侧的设计器表面并选择"自定义布局"。然后，右键单击 TaskCardView 布局项目并选择"隐藏文本"。
Create a Navigation Item that Shows the View with the Custom Control
创建使用自定义控件显示视图的导航项
Navigate to the NavigationItems | Items | Default | Items node. Right-click the Items node and select Add… | NavigationItem from the invoked context menu.
导航到导航项 |项目 |默认值 |项目节点。右键单击"项目"节点并选择"添加..." |从调用的上下文菜单导航项。
For the newly added node, in the IModelNavigationItem.View dropdown list, select the View you created earlier (TaskCardView).
对于新添加的节点，在 IModel 导航项目.查看下拉列表中，选择您之前创建的视图（任务卡视图）。
Run the WinForms application and click Task Card View in the navigation. The Card View bound to the DemoTask collection will be displayed (see the image in the beginning of this topic).
运行 WinForms 应用程序，然后单击导航中的任务卡视图。将显示绑定到 DemoTask 集合的卡片视图（请参阅本主题开头的图像）。