Compartilhar via


DataServiceCollection<T>.LoadAsync Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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)

Syntax

'Declaration
Public Sub LoadAsync
public void LoadAsync()

Exceptions

Exception Condition
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.

Remarks

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.

Version Information

Silverlight

Supported in: 5, 4

Platforms

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