DataServiceCollection<T>.LoadAsync Method (IQueryable<T>)
Asynchronously loads the collection by executing a DataServiceQuery<TElement>.
Namespace: System.Data.Services.Client
Assembly: System.Data.Services.Client (in System.Data.Services.Client.dll)
Parameters
- query
- Type: System.Linq.IQueryable<T>
The DataServiceQuery<TElement> that, when executed, returns the entities to load into the collection.
| Exception | Condition |
|---|---|
| ArgumentException |
When query is null or not a DataServiceQuery<TElement>. |
| InvalidOperationException |
When a previous call to LoadAsync is not yet complete. |
Because the LoadAsync method is asynchronous, the method returns before a response to the data service is received. You must handle the LoadCompleted event to access the QueryOperationResponse<T> that contains information about the result of the load operation. Items are loaded into the collection when the load operation is complete, whether or not the LoadCompleted event is handled.
The LoadAsync method can be called only once on the UI thread. The method cannot be called again until after the LoadCompleted event is raised. The LoadCompleted event is raised whether or not the query succeeds.
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.