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 呼叫尚未完成時。 |
備註
當您使用 [加入服務參考] 對話方塊或 DataSvcUtil.exe 工具搭配 /binding 選項來產生用戶端資料服務類別時，傳回集合的導覽屬性會以 DataServiceCollection<T> 執行個體的形式產生。 從這類屬性取得 DataServiceCollection<T> 執行個體時，將會使用 LoadAsync 方法將資料服務中的相關實體載入集合中。
因為 LoadAsync 方法是非同步的，所以此方法會在收到資料服務的回應之前傳回。 您必須處理 LoadCompleted 事件來存取 QueryOperationResponse<T>，其中包含有關載入作業結果的資訊。 當載入作業完成時，項目便會載入集合中，不論是否處理 LoadCompleted 事件。
LoadAsync 方法只能在 UI 執行緒上呼叫一次。 要等到引發 LoadCompleted 事件之後，才能再次呼叫此方法。 不論查詢是否成功，都會引發 LoadCompleted 事件。