DashboardXpoDataSource Class

Retrieves data from XPO (eXpress Persistent Objects).

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v19.2.Core.dll

NuGet Packages: DevExpress.Dashboard.Core, DevExpress.WindowsDesktop.Win.Dashboard

Declaration

C#

public class DashboardXpoDataSource :
    XPObjectSource,
    IDashboardDataSource,
    IDashboardComponent,
    IComponent,
    IDisposable,
    ISupportInitialize,
    ISupportPrefix,
    IDashboardDataSourceInternal,
    IExternalSchemaConsumer,
    IFederationDataProvider,
    IXpoDataSourceInfo,
    ICloneable<DashboardXpoDataSource>

VB.NET

Public Class DashboardXpoDataSource
    Inherits XPObjectSource
    Implements IDashboardDataSource,
               IDashboardComponent,
               IComponent,
               IDisposable,
               ISupportInitialize,
               ISupportPrefix,
               IDashboardDataSourceInternal,
               IExternalSchemaConsumer,
               IFederationDataProvider,
               IXpoDataSourceInfo,
               ICloneable(Of DashboardXpoDataSource)

Remarks

The DashboardXpoDataSource allows you to obtain data that XPO ((eXpress Persistent Object) retrieves from a data source.

Design Time

To connect to the XPO data source, perform the following steps.

1. Click the New Data Source button in the Data Source ribbon tab.

   

2. On the first page of the invoked Data Source Wizard dialog, select eXpress Persistent Objects (XPO) and click Next. The wizard allows you to specify the entity type.

   

   Select the Data Source Type

   

   Choose an Entity Type

Runtime

1. Instantiate the DashboardXpoDataSource object and use the ConnectionStringName property to specify the name of the connection string defined in the application configuration file.

2. Pass the persistent object type to the SetEntityType method.

Note

The complete sample project How to Bind a Dashboard to the XPO Data Source at Runtime is available in the DevExpress Examples repository.

The code sample below illustrates how to connect to the XPO data source.

C#

using DevExpress.DashboardCommon;
// ...
public static DashboardXpoDataSource CreateXpoDataSource()
{
    DashboardXpoDataSource dataSource = new DashboardXpoDataSource()
    {
        ConnectionStringName = "northwind"
    };
    dataSource.SetEntityType(typeof(nwind.Customers));
    return dataSource;
}

VB.NET

Imports DevExpress.DashboardCommon
' ...
Public Shared Function CreateXpoDataSource() As DashboardXpoDataSource
  Dim dataSource As New DashboardXpoDataSource() With {.ConnectionStringName = "northwind"}
  dataSource.SetEntityType(GetType(nwind.Customers))
  Return dataSource
End Function

Implements

IDataComponent

IDashboardDataSource

Inheritance

Object

MarshalByRefObject

Component

DevExpress.DataAccess.DataComponentBase

XPObjectSource

DashboardXpoDataSource