Skip to main content

Prepare Dashboard Storage in ASP.NET Web Forms

  • 2 minutes to read

Dashboard storage is a location of dashboards you use in your Web Dashboard application. Users can save new dashboards to this storage and open existing dashboards.

Dashboard Storage Types

In-Memory Storage

The in-memory storage is a DashboardInMemoryStorage instance. If you do not register your dashboard storage, the Web Dashboard creates an in-memory storage and uses it to keep dashboards.

File Storage

A file storage is used to keep dashboard XML definitions in a file system (for example, on a server). Create a DashboardFileStorage instance to use this storage type.

You can also use the ASPxDashboard.DashboardStorageFolder property to set a path to a folder used to keep dashboards. This action is the equivalent of creating DashboardFileStorage.

Custom Storage

You can manage dashboards in your own way. Implement the IDashboardStorage or IEditableDashboardStorage interfaces and configure methods used to manage dashboards:

IDashboardStorage.GetAvailableDashboardsInfo
Returns information about stored dashboards.
IDashboardStorage.LoadDashboard
Allows you to load the dashboard from the storage.
IDashboardStorage.SaveDashboard
Allows you to save the dashboard to the storage.
IEditableDashboardStorage.AddDashboard
Allows you to add a new dashboard to the storage.

View Example: How to save dashboards to a DataSet View Example: How to Load and Save Dashboards from/to a Database

Dashboard Type Storage

This storage is used for dashboards created in Visual Studio at design time.

You can use DashboardTypeStorage only in Viewer mode.

Register Dashboard Storage

To register dashboard storage for the ASPxDashboard control, pass the newly created storage to the ASPxDashboard.SetDashboardStorage or DashboardConfigurator.SetDashboardStorage method. The selected method depends on the server-side API used in your app.

Manage Access Rights

See the following topic for information about access rights: Security Considerations.

Load a Dashboard

See the following topic for information how to load a dashboard: Load a Dashboard in ASP.NET Web Forms.