Skip to main content

XPO Data Source

  • 2 minutes to read

The Data Source Configuration Wizard allows you to bind the PivotGridControl to an XPO data source. This topic goes over the steps needed to do this.

  1. Click the Data Source Wizard button placed on the PivotGridControl or use the corresponding command in the control’s smart tag.

    WinPivot_DataSourceButton

  2. In the invoked Data Source Configuration Wizard, select DevExpress ORM Tool (XPO)

    DataSourceConfigurationWizard_SelectXPO

    … and click the New Data Source button placed within the Data Sources area.

    DataSourceConfigurationWizard_SelectAdoNet_NewDataSource

  3. The following message will appear.

    DataSourceConfigurationWizard_RebuildWarning

    Click OK.

  4. On the next page, you can generate persistent objects using the ORM Data Model Wizard or you can create persistent objects manually. Select the required option, specify the object name and click Add.

    Pivot_AddXPODataModelDialog

    To learn how to work with XPO, see eXpress Persistent Objects.

    Important

    After you created a data model, rebuild the solution.

  5. After creating a data model, click the Data Source Wizard button again.

    WinPivot_DataSourceButton

  6. In the invoked Data Source Configuration Wizard, select the created data model.

    DataSourceConfigurationWizard_XPO_SelectModel

    Click Next.

  7. On the next page, select the required binding method.

    DataSourceConfigurationWizard_XPO_SelectBindingMethod

    • Binding via the XPCollection Component - Bind to data using the XPCollection component that is a collection of persistent objects.
    • Binding via the XPView Component - Bind to data using the XPView component that is only intended for displaying data.
    • Server Side Data Processing - Bind to data using server mode. In this case, all data processing is delegated to the database server.

    Select Binding via the XPCollection Component and click Next.

  8. On the final page, you can specify the table.

    DataSourceConfigurationWizard_XPO_Finish

    Select the required table and click Finish.

  9. The PivotGridControl will be bound to the created XPCollection.

    WinPivot_BoundToDataXPCollection

    You can now use the Retrieve Fiels command to retrieve the available data source fields. As an alternative, you can add specific fields manually using the PivotGrid Designer. To do this, use the Run Designer… command.

    Important

    To initialize the database connection for the created data model, do one of the following.

    • If you used the ORM Data Model Wizard to create a data model, call the ConnectionHelper.Connect method in the application’s Main method.
    • If you did not use the wizard, then manually connect to a data base instead of calling ConnectionHelper.Connect.