Skip to main content

DataRequestOptions.ItemDataLoadingMode Property

Gets or sets whether to load data for items that are not currently displayed.

Namespace: DevExpress.DashboardWeb

Assembly: DevExpress.Data.v24.1.dll

NuGet Package: DevExpress.Data

Declaration

public ItemDataLoadingMode ItemDataLoadingMode { get; set; }

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
.DataRequestOptions .ItemDataLoadingMode
DashboardExtensionSettings
.DataRequestOptions .ItemDataLoadingMode

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.
See Also