Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
LoadAsync Method
Collapse the table of content
Expand the table of content

DataServiceCollection<T>.LoadAsync Method

Asynchronously loads items into the collection, when it represents the navigation property of an entity.

Namespace:  System.Data.Services.Client
Assembly:  System.Data.Services.Client (in System.Data.Services.Client.dll)

public void LoadAsync()

ExceptionCondition
InvalidOperationException

When the collection does not belong to a parent entity.

-or-

When the parent entity is not tracked by the DataServiceContext.

-or-

When a previous call to LoadAsync is not yet complete.

When you use the Add Service Reference dialog or the DataSvcUtil.exe tool with the /binding option to generate the client data service classes, navigation properties that return a collection are generated as instances of DataServiceCollection<T>. When an instance of DataServiceCollection<T> is obtained from such a property, the LoadAsync method is used to load the related entities from the data service into the collection.

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:
© 2015 Microsoft