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 事件。