Export (0) Print
Expand All

DataServiceCollection<T>.LoadAsync Method (IQueryable<T>)

WCF Data Services 5.0

Asynchronously loads the collection by executing a DataServiceQuery<TElement>.

Supported only by the WCF Data Services 5.0 client for Silverlight.

Namespace:  System.Data.Services.Client
Assembly:  Microsoft.Data.Services.Client.SL (in Microsoft.Data.Services.Client.SL.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.

Show:
© 2014 Microsoft