Silverlight 3異步域操作詳解
51CTO推薦:一步一步學Silverlight
在Silverlight 3的異步域操作可謂家常便飯。因此,全面地理解異步域操作相關知識是基于RIA服務技術開發Silverlight應用的必修課。在本文中,我們將以精簡的形式剖析RIA服務編程中異步域操作中涉及的要點并歸納應注意的問題。
1.Silverlight 3異步域操作
DomainContext支持3種類型域操作:Query,Submit和Invoke。這些操作中的的每一種都有一個相應的操作類型用于描述正在進行中的異步操作。例如,當一個查詢加載到一個DomainContext中,異步的Load調用將立即返回一個LoadOperation實例。請參考如下代碼:
- HRContext _ctxt = new HRContext();
- var query = from e in _ctxt.GetEmployeesQuery()
- where e.ManagerID == 1
- select e;
- LoadOperation
lo = _ctxt.Load(query);
上面的操作結果既提供了有關于正在進行的操作的動態的可綁定的狀態信息,也提供了可取消當前操作的支持。同樣地,一個提交請求將返回一個SubmitOperation,而服務操作調用將返回一個InvokeOperation。
接下來,我們將詳細地討論這些Silverlight 3異步域操作及其基類有關知識。
2.基類OperationBase
這個類是所有.NET RIA服務異步操作的基類。這個類實現了接口INotifyPropertyChanged,因此,它的操作狀態成員可以是數據綁定型的,而且當操作的完成狀態改變時,將會引發通知。
基類OperationBase提供了如下成員:
◆IsComplete—一旦操作完成便返回true。注意,當一項操作成功結束,或者是完成但仍帶有錯誤,或者是此操作被取消,都被認為是操作完成。
◆Completed事件—當一項操作完成時引發此事件。
◆UserState—與操作相關的用戶狀態。
◆Cancel()/CanCancel/IsCanceled—如果操作能夠被取消并且沒有完成,那么CanCancel將返回true。在取消操作前,將會檢查CanCancel的值。如果操作已經完成,則將拋出一個異常。
◆Error/HasError—如果操作已經完成,但發生了錯誤,那么HasError的值將為true,而且Error中將包含相應的異常信息。
下面你將會看到,一個域操作中還可以指定一個操作完成對應的回調函數。如果指定了一個回調函數,那么,此回調函數在任何情況下也會被調用,無論此操作是成功結束,還是完成但仍帶有錯誤,還是此操作被取消。
另外值得注意的是,這個回調函數在Completed事件引發以前也會被調用。
3.LoadOperation操作
DomainContext.Load
◆Entities—一個已加載的實體的強類型枚舉類型。一旦調用返回,集合即變為空。注意,此集合實現了接口INotifyCollectionChanged,當操作完成時自新將得到更新。
◆AllEntities—由查詢操作加載的所有實體的集合,而且還包括任何相關聯的實體。注意,此對象也實現了接口INotifyCollectionChanged。一旦調用返回,集合即變為空。注意,此對象也實現了接口INotifyCollectionChanged,當操作完成時自新將得到更新。
◆TotalEntityCount—返回查詢中對應的所有服務器端實體總數。
◆EntityQuery—用于初始化加載操作。
◆MergeOption—加載操作中指定的MergeOption。
下面的代碼展示了如何指定一個加載回調函數:
- object state =……//用戶狀態
- LoadOperation
lo = _ctxt.Load(query, - EmployeesLoadedCallback, state);
- ……
- private void EmployeesLoadedCallback(LoadOperation
lo) - {
- if (!lo.HasError)
- {
- object state = lo.UserState;
- foreach (Employee employee in lo.Entities)
- {
- //處理已加載的實例
- }
- }
- else
- {
- //處理錯誤
- }
- }
- 要指定一個完成事件處理器,可以像下面這樣使用LoadOperation.Completed。
- object state =……//用戶狀態
- LoadOperation
lo = _ctxt.Load(query, null, state);- lo.Completed += this.OnEmployeesLoaded;
- ……
- private void OnEmployeesLoaded(object sender, EventArgs e)
- {
- LoadOperation
lo = (LoadOperation )sender; - ……
- }
當有許多方面(可能是外面的)對當前操作進度感興趣時,那么上面的事件處理器創建是非常有用的。
4.SubmitOperation操作
DomainContext.SubmitChanges方法將返回一個SubmitOperation的實例。其中,SubmitOperation代表了正在進行的異步提交操作;此外,DomainContext.SubmitChanges方法還提供了下面額外的狀態及功能支持:
◆ChangeSet—正在提交的EntityChangeSet
◆EntitiesInError—對于一個產生校驗或沖突錯誤的提交操作來說,它代表了產生錯誤的實體的集合。
另外,回調函數及Completed事件的提交與前面解釋的LoadOperation中的使用方式一致,在此不再贅述。
六、InvokeOperation操作
當調用一個ServiceOperation(服務操作)時,將返回一個強類型的InvokeOperation
◆OperationName—要調用的操作的名字
◆Parameters—要操作的名字/值形式的字典參數
◆ValidationErrors—當調用失敗時對應的檢驗錯誤信息的集合
◆Value—ServiceOperation返回的值
另外,回調函數及Completed事件的提交與前面解釋的LoadOperation中的使用方式一致,在此不再贅述。
5.小結
本文簡要地總結了RIA服務開發中Silverlight 3異步域操作支持的3種類型的重要的域操作:Query,Submit和Invoke。其中的每一種操作都有一個相應的操作類型用于描述正在進行中的異步操作。我們對這些RIA服務操作使用參數、注意事項及使用場景等進行了歸納,并給出片斷代碼例證。
【編輯推薦】