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.v26.1.dll
NuGet Package: DevExpress.Data
Declaration
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 |
|
| DashboardExtensionSettings |
|
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.
