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