Skip to main content

DashboardConfigurator Class

Namespace: DevExpress.DashboardWeb

Assembly: DevExpress.Dashboard.v24.1.Web.dll

NuGet Package: DevExpress.Web.Dashboard.Common

Declaration

public class DashboardConfigurator :
    DashboardConfiguratorBase,
    IDashboardServiceProvider,
    IDataSourceCacheEventsProvider,
    IDashboardCustomizationProvider,
    IClientTrustLevelVerification,
    IDataSourceWizardCustomizationProvider

Remarks

Important

For information on how to use the DashboardConfigurator‘s API, see the following topic: Dashboard Backend

To prepare the dashboard control for the first use, you need to create dashboard and data source storages.

  1. Use the static DashboardConfigurator.SetDashboardStorage method to create a storage that will contain dashboards. You can use predefined dashboard storages (DashboardFileStorage or DashboardInMemoryStorage) or you can implement the IDashboardStorage interface to provide your own logic for managing dashboards.

    Note

    The DashboardConfigurator uses the DashboardInMemoryStorage if you do not create the dashboard storage.

  2. Prepare data sources that will be used to supply dashboards with data. You can do this in two ways.

The DashboardConfigurator class also exposes an API used to supply the dashboard with data at runtime (for instance, using the DashboardConfigurator.ConfigureDataConnection or DashboardConfigurator.DataLoading events).

The following example shows how to set up ASPxDashboard with the DashboardConfigurator settings.

Set the UseDashboardConfigurator property to true and use the DashboardConfigurator to process data-related operations and handle data-related events (set the dashboard /data source storage, specify a connection provider, etc).

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="WebFormsDashboardConfigurator.Default" %>

<%@ Register Assembly="DevExpress.Web.v18.2, Version=18.2.5.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" Namespace="DevExpress.Web" TagPrefix="dx" %>

<%@ Register Assembly="DevExpress.Dashboard.v18.2.Web.WebForms, Version=18.2.5.0, Culture=neutral, PublicKeyToken=b88d1754d700e49a" Namespace="DevExpress.DashboardWeb" TagPrefix="dx" %>

<!DOCTYPE html>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Web Dashboard</title>
</head>
<body>
    <form id="form1" runat="server">
        <div style="position: absolute; left: 0; right: 0; top:0; bottom:0;">
            <dx:ASPxDashboard ID="ASPxDashboard1" runat="server" Width="100%" Height="100%"  ClientInstanceName="webDashboard">
            </dx:ASPxDashboard>
        </div>
    </form>
</body>
</html>
See Also