DataRequestOptionsBuilder.ItemDataLoadingMode(ItemDataLoadingMode) Method

Specifies whether to load data for items that are not displayed.

Namespace: DevExpress.DashboardAspNetCore

Assembly: DevExpress.Dashboard.v21.2.AspNetCore.dll

NuGet Package: DevExpress.AspNetCore.Dashboard

Declaration

C#

public DataRequestOptionsBuilder ItemDataLoadingMode(
    ItemDataLoadingMode mode
)

VB.NET

Public Function ItemDataLoadingMode(
    mode As ItemDataLoadingMode
) As DataRequestOptionsBuilder

Parameters

Name	Type	Description
mode	ItemDataLoadingMode	A ItemDataLoadingMode enumeration value that specifies whether to load data for items that are not displayed.

Returns

Type	Description
DataRequestOptionsBuilder	A reference to this instance after the operation has completed.

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. The control 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.