Skip to main content
All docs
V25.1
  • DataRequestOptions.ItemDataLoadingMode Property

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

    Namespace: DevExpress.DashboardWeb

    Assembly: DevExpress.Data.v25.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