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)

public void LoadAsync(
	IQueryable<T> query
)

Parameters

query
Type: System.Linq.IQueryable<T>
The DataServiceQuery<TElement> that, when executed, returns the entities to load into the collection.

ExceptionCondition
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.

Silverlight

Supported in: 5, 4

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

ADD
Show: