實例參考OAY Report
'---------------------------
服務端(.cs):
客戶端(.aspx):
'---------------------------
AJAX技術所提倡的無刷新回調,在原來的技術中需要寫大量的javascript代碼或使用一些AJAX框架,使得開發效率和可維護性大大降低。其實ASP.NET2.0中,已經提供了這樣的接口,這就是ICallbackEventHandler。
關於ICallbackEventHandler網上已經有很多文章介紹了,這篇實爲畫蛇添足。
ICallbackEventHandler存在於System.Web.UI中,我們先做一個非常簡單的例子來試用一下。
第一步,在VS2005中建立一個新的WEB窗件。
第二步,在ASPX中,放上一段HTML代碼(如下):
<body>
<form id="form1" runat="server">
<div>
<button οnclick="CallServer()">CallServer</button>
</div>
</form>
</body>
第三步,然後在<HEAD></HEAD>中放入一段JavaScript腳本:
<script type="text/javascript">
function CallServer()
{
var prodUCt = "測試";
<%= ClientScript.GetCallbackEventReference(this, "product", "ReceiveServerData",null)%>;
}
function ReceiveServerData(rValue)
{
alert(rValue);
}
</script>
第四步,在此ASPX的後臺CS代碼中,繼承ICallbackEventHandler接口,並實現接口中的兩個方法:
ICallbackEventHandler.GetCallbackResult()
和
ICallbackEventHandler.RaiseCallbackEvent(string eventArgument)
第五步,增加一個變量CallBackValue,並修改接口的兩個方法爲:
private string CallBackValue = string.Empty;
string ICallbackEventHandler.GetCallbackResult()
{
return CallBackValue + ",ok";
}
void ICallbackEventHandler.RaiseCallbackEvent(string eventArgument)
{
this.CallBackValue = eventArgument;
}
第六步,運行,界面上會出現一個按鈕,點擊後,會將“測試”這個字符串傳至後臺,後臺C#代碼將字符串加上“,OK”後返回給客戶端的JavaScript代碼,並顯示。
以上六步,就可以實現無刷新回調了。現在,我們來分析一下幾段代碼。
先看第三步中的JavaScript代碼,其中的CallServer()方法中進行了回調,回調的語句爲:
<%= ClientScript.GetCallbackEventReference(this, "product", "ReceiveServerData",null)%>;
裏面四個參數中第二個參數指定將product這個JavaScript中的字符串變量傳回後臺,第三個參數指定了從後臺返回時接收返回信息的JavaScript方法ReceiveServerData(string Value)。
第五步中後臺的兩個方法,一個ICallbackEventHandler.RaiseCallbackEvent(string eventArgument)用來接收前臺JavaScript中傳來的字符串變量,並賦值給內部變量this.CallBackValue,另一個方法ICallbackEventHandler.GetCallbackResult()將變更後的內部變量this.CallBackValue返回給前臺JavaScript方法ReceiveServerData(string Value)。
調用的順序是: (前臺)CallServer() --> (後臺)ICallbackEventHandler.RaiseCallbackEvent(string eventArgument) --> (後臺)ICallbackEventHandler.GetCallbackResult() --> (前臺)ReceiveServerData(string Value)。
整個調用過程非常簡單,而其中非常關鍵的一步是第三步的<%= ClientScript.GetCallbackEventReference(this, "product", "ReceiveServerData",null)%>;
這個方法,以下是從網上找來的一段資料,大家可以看看。
GetCallbackEventReference使得客戶端方法在客戶端請求結束時得到回收。 它也讓CallBackManager 確定產生哪種回叫方法。 在這個例子內使用的被重載的方法是:
public string GetCallbackEventReference(
string target, string argument,
string clientCallback, string context,
string clientErrorCallback)
從這個方法返回的string是:
__doCallback('__Page',arg,CallBackHandler,ctx, ErrorCallBack)
另一個重載方法是:
public string GetCallbackEventReference(
Control control, string argument,
string clientCallback, string context)
public string GetCallbackEventReference(
Control control, string argument,
string clientCallback, string context,
string clientErrorCallback)