Share via


DataServiceCollection<T>.LoadAsync 方法

当集合表示实体的导航属性时,以异步方式将项加载到该集合中。

只有 Silverlight 的 WCF Data Services 5.0 客户端支持。

命名空间:  System.Data.Services.Client
程序集:  Microsoft.Data.Services.Client(在 Microsoft.Data.Services.Client.dll 中)

语法

声明
Public Sub LoadAsync
用法
Dim instance As DataServiceCollection

instance.LoadAsync()
public void LoadAsync()
public:
void LoadAsync()
member LoadAsync : unit -> unit 
public function LoadAsync()

异常

异常 条件
InvalidOperationException

当集合不属于父实体时。

- 或 -

当父实体未由 DataServiceContext 跟踪时。

- 或 -

LoadAsync 的前一次调用尚未完成时。

注释

当您使用**“添加服务引用”**对话框或带 /binding 选项的 DataSvcUtil.exe 工具来生成客户端数据服务类时,将作为 DataServiceCollection<T> 的实例生成返回集合的导航属性。 当 DataServiceCollection<T> 的实例是从这种属性获取的时,将使用 LoadAsync 方法从数据服务将相关实体加载到集合中。

由于 LoadAsync 方法是异步的,因此该方法将在收到数据服务的响应之前返回。 必须处理 LoadCompleted 事件才能访问包含加载操作结果相关信息的 QueryOperationResponse<T>。 无论是否处理了 LoadCompleted 事件,当加载操作完成时,相关项都将加载到集合中。

在 UI 线程中只能调用一次 LoadAsync 方法。 除非在引发了 LoadCompleted 事件之后,否则不能再次调用该方法。 无论查询是否成功,都会引发 LoadCompleted 事件。

请参阅

参考

DataServiceCollection<T> 类

LoadAsync 重载

System.Data.Services.Client 命名空间