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.2.dll
NuGet Package: DevExpress.Data
#Declaration
public ItemDataRequestMode ItemDataRequestMode { get; set; }
#Property Value
Type | Description |
---|---|
Item |
A Item |
Available values:
Name | Description |
---|---|
Auto | For Web Forms, the auto mode is Batch |
Separate |
Detailed items grouped by the same master filter item perform simultaneous separate requests. |
Batch |
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 Item |
---|---|
ASPx |
|
Dashboard |
|
#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.