方法：XAFビュー（リサイズ）でカスタムデータバインドコントロールを表示する方法：XAFビューでカスタムデータバインドコントロールを表示する（リサイズ）で

この例では、ビューにカスタムデータバインド（データ対応）コントロールを追加し、WinFormsのXAFアプリケーションのナビゲーションから、このビューを表示する方法を示しています。デモの目的のために、この例では、あなたが追加されますGRIDCONTROLのでコントロールをCardViewにEFDemoの（にインストールされたアプリケーション％PUBLIC％を\ドキュメント\ DevExpress社のデモ19.2 \コンポーネント\ eXpressApp Frameworkの\ EFDemoCodeFirstデフォルト）。しかし、あなたはあなた自身のXAFアプリケーション内の他のカスタムコントロールと同じアプローチを使用することができます。

（データ対応）ビューに制御データバインディングをカスタマイズしリサイズXAFアプリケーションナビゲーションのビューを表示する方法この実施例は示しています。デモの目的のために、この例では、あなたはCardViewがEFDemoアプリケーション（インストール％PUBLIC％で_ドキュメント_DevExpressプレゼンテーション19.2_コンポーネントeXpressAppフレームワーク_EFDemoCodeFirstデフォルト）にGRIDCONTROLコントロールを追加使用します。しかし、あなたはそれらのXAFアプリケーション内の他のカスタムコントロールのために、同じ方法を使用することができます。

ヒントヒント

ASP.NETのための同様の例がで利用可能である方法：XAFビューのカスタムデータバインドコントロールを表示（ASP.NET）

ASP.NETは、同様の例を提供する：「のXAFビューのカスタムデータバインドコントロールが表示方法」（ASP.NET）で

ユーザーコントロールを作成します。

ユーザーコントロールを作成します。

リサイズモジュールプロジェクトでは、作成しユーザーコントロールを。プロジェクトを右クリックして選択します | ユーザーコントロール...

リサイズモジュールプロジェクトでは、ユーザーコントロールを作成します。プロジェクトを右クリックして追加」を選択|ユーザーコントロール...

例えば、必要なコントロールを追加しますGRIDCONTROLをから、ツールボックスのデザイナーに。

所望の制御（例えば、ツールボックスからGRIDCONTROLの設計者）。

Customize the control as required; e.g., convert the GridControl.MainView to CardView.

根据需要自定义控件;例如，将网格控制.MainView 转换为卡视图。

Tip 提示

You can also add the CollectionDataSource component from the DX.19.2: XAF Data Sources for Reports toolbox group and then bind the control to this component. Use the DataSourceBase.ObjectTypeName property to specify the required business object type. This will allow you to see the data columns in the designer and customize them as required. Actual data binding will be performed further in code.

还可以从 DX.19.2：用于报表的工具箱组添加收集数据源组件，然后将控件绑定到此组件。使用 DataSourceBase.ObjectTypeName 属性指定所需的业务对象类型。这将允许您在设计器中查看数据列，并根据需要对其进行自定义。实际数据绑定将在代码中进一步执行。

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>();
    }
}

Tip 提示

You can also use the application parameter to access certain Application Model settings using the XafApplication.Model property and customize the control accordingly.

您还可以使用应用程序参数使用 XafApplication.Model 属性访问某些应用程序模型设置，并相应地自定义控件。

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 布局项目并选择"隐藏文本"。

Note 注意

You can add the ControlViewItem View Item to any existing Detail View or Dashboard View instead of creating a new Dashboard View.

您可以将 ControlViewItem 视图项添加到任何现有详细信息视图或仪表板视图，而不是创建新的仪表板视图。

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コレクションにバインドされています。