Skip to main content

DataRequestOptions.ItemDataRequestMode Property

Gets or sets whether a dashboard control loads dashboard items’ data using batch requests or separate requests.

Namespace: DevExpress.DashboardWeb

Assembly: DevExpress.Data.v24.1.dll

NuGet Package: DevExpress.Data

Declaration

public ItemDataRequestMode ItemDataRequestMode { get; set; }

Property Value

Type Description
ItemDataRequestMode

A ItemDataRequestMode enumeration value that specifies a data request mode.

Available values:

Name Description
Auto

For Web Forms, the auto mode is BatchRequests. For other platform, the auto mode is SeparateRequests.

SeparateRequests

Detailed items grouped by the same master filter item perform simultaneous separate requests.

BatchRequests

Detailed items grouped by the same master filter item perform one batch request.

Property Paths

You can access this nested property as listed below:

Object Type Path to ItemDataRequestMode
ASPxDashboard
.DataRequestOptions .ItemDataRequestMode
DashboardExtensionSettings
.DataRequestOptions .ItemDataRequestMode

Remarks

When a Web Dashboard loads data, it groups data dashboard items by master-filter items. While dashboard data is loading, the group waits when its master-filter item is loaded and then performs simultaneous separate requests for each dashboard item in this group. A blocking item temporarily blocks data receiving for detailed items: data for detailed items depends on the data from blocking items (it is the Range Filter item, single master-filter items, and filter items when the neutral filter mode is disabled).

This behavior allows you to render lightweight items with little loading time, while heavy dashboard items with long loading time are waiting for a response. In certain cases, this is not optimal behavior. For example, in Web Forms, parallel query processing is disabled. In this case, the batch requests mode allows you to improve performance when items grouped by one master-filter item are send in a one request.

See Also