DataRequestOptions.ItemDataLoadingMode Property
Gets or sets whether to load data for items that are not currently displayed.
Namespace: DevExpress.DashboardWeb
Assembly: DevExpress.Data.v23.2.dll
NuGet Package: DevExpress.Data
Declaration
Property Value
| Type | Description |
|---|---|
| ItemDataLoadingMode | A ItemDataLoadingMode enumeration value that specifies whether to load data for items that are currently invisible. |
Available values:
| Name | Description |
|---|---|
| Always | Load all dashboard items. |
| OnDemand | Load dashboard items on demand. |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to ItemDataLoadingMode |
|---|---|
| ASPxDashboard |
|
| DashboardExtensionSettings |
|
Remarks
Use the ItemDataLoadingMode property to specify whether to load data for all items in a dashboard or only for visible items.
The control loads data for all dashboard items in a dashboard by default (the ItemDataLoadingMode property value is Always).
If you set the ItemDataLoadingMode property to OnDemand, the control loads data as follows:
- If you have more than one tab page, data is loaded only for the active page. Web Dashboard loads the remaining dashboard items on demand (for instance, when you switch to another tab page).
- If a dashboard has applied filters, hidden Master Filter items that affect the visible dashboard items are also loaded.
- Dashboard items that are shown with the Display Item As Page option enabled are considered visible and data for all such items are requested when it is loaded the first time.