Manual vs. Auto Loading

You can load data manually by calling the RadDataServiceDataSource.Load method or you can let the control perform an automatic load when a change affecting the query occurs. If you set the AutoLoad property to true, an automatic load will be initiated each time one of the following happens:

  • When a filter descriptor is added, removed or edited in the FilterDescriptors collection of the control.

  • When a sort descriptor is added, removed or edited in the SortDescriptors collection of the control.

  • When a group descriptor is added, removed or edited in the GroupDescriptors collection of the control.

WCF Data Services (the OData protocol) do not support true grouping on the server. When you try to group through RadDataServiceDataSource, it will simply sort the data on the server based on the grouping criteria and when it arrives, it will group it on the client.

  • When the PageIndex changes.

When the PageIndex changes, a load request will be sent to the server even if the AutoLoad property is false.

While the control is asynchronously waiting for the server to respond, it is in a loading state (IsLoading is true and CanLoad is false). Calling the Load method or triggering an AutoLoad while the control is in this state will be ignored and will have absolutely no effect. You need to cancel a pending load with the CancelLoad method before executing a new one.

In this article