dashboard-devexpress-dot-dashboardwin-dot-dashboarddesigner-931ca155.md
Allows you to provide data for the DashboardObjectDataSource in asynchronous mode.
Namespace : DevExpress.DashboardWin
Assembly : DevExpress.Dashboard.v25.2.Win.dll
NuGet Package : DevExpress.Win.Dashboard
public event DataLoadingEventHandler AsyncDataLoading
Public Event AsyncDataLoading As DataLoadingEventHandler
The AsyncDataLoading event's data class is DataLoadingEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Data | Gets or sets data for the current data source. |
| DataId | Gets an object data source’s unique identifier. |
| DataSourceComponentName | Get the component name of the data source for which the event has been raised. |
| DataSourceName | Gets the name of the data source for which the event has been raised. |
| OverwriteDataSourceProperty | Specifies whether the DataSource and DataMember properties of the DashboardObjectDataSource are set when data is supplied in the event handler. |
| Parameters | Provides access to parameter values passed to the object data source. |
The AsyncDataLoading event is raised in asynchronous mode when the dashboard loads data from the DashboardObjectDataSource. Use the event parameter’s e.Data property to provide data for this data source. The data object should implement the IEnumerable or IListSource interface.
Important
The DashboardDesigner.AsyncDataLoading and DashboardDesigner.DataLoading events in asynchronous mode may occur multiple times while you design a dashboard and change the dashboard object model. To improve performance, do not call time-consuming methods in the event handler.
For an example of use, review the Dashboard Designer in Asynchronous Mode with Object Data Source project that is available in the DevExpress Examples repository.
Note
You cannot access a control’s properties such as the DashboardControl.Dashboard property through the AsyncDataLoading event because it receives data asynchronously from a background thread.
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the AsyncDataLoading event.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.
dashboardDesigner1.DataLoading += DashboardDesigner1_DataLoading;
dashboardDesigner1.AsyncDataLoading += DashboardDesigner1_AsyncDataLoading;
Task.Run(async () => await LoadData());
AddHandler dashboardDesigner1.DataLoading, AddressOf DashboardDesigner1_DataLoading
AddHandler dashboardDesigner1.AsyncDataLoading, AddressOf DashboardDesigner1_AsyncDataLoading
Task.Run(Async Function()
See Also