Asp页面客户端回调功能即ICallbackEventHandler接口使用笔记

  今天看【Asp.NET 3.5 SP1高级编程(第六版)中文版】时,看到客户端回调,以前只知道Asp的回调函数__doPostBack(),今天看到回调就有感觉比较难(对于我这只小鸟来说),果然看到一个例子,怎么也看不懂,只要自己测试,然后才发现是这样,但是里面的原理还是不懂,以后会明白的,开始正题,下面通过一个例子讲解客户端回调功能(ICallbackEventHandler接口)如何实现的。

页面代码:

 1 <%@ Page Language="C#" AutoEventWireup="true" CodeFile="RandomNumber.aspx.cs" Inherits="RandomNumber" %>
2
3 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4
5 <html xmlns="http://www.w3.org/1999/xhtml">
6 <head runat="server">
7 <title>使用回调功能把一个随机值填充到Web页面上</title>
8 <script type="text/javascript">
9 function GetNumber()
10 {
11 UseCallback();
12 }
13
14 function GetRandomNumberFromServer(TextBox1, context)
15 {
16 document.forms[0].TextBox1.value =TextBox1;
17 }
18 </script>
19 <script type="text/javascript">
20 function CallServer(index)
21 {
22 UseServerEvent(index);
23 }
24
25 function GetValueFromServer(value, value2)
26 {
27 document.forms[0].TextBox2.value =value;
28 //alert(value);
29 //alert(value2);
30 }
31 </script>
32 </head>
33 <body>
34 <form id="form1" runat="server">
35 <div>
36 <input type="button" id="Button1" value="Get Random Number" onclick="GetNumber()" />
37 <br />
38 <br />
39 <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
40 </div>
41 <hr />
42 <h3>此为练习</h3>
43 <div>
44 <input type="button" id="Button2" value="Get Return Value" onclick="CallServer('Jolin')" />
45 <br />
46 <br />
47 <asp:TextBox ID="TextBox2" runat="server"></asp:TextBox>
48 </div>
49 <hr />
50 </form>
51 </body>
52 </html>

后台代码:

 1 using System;
2 using System.Collections;
3 using System.Configuration;
4 using System.Data;
5 using System.Linq;
6 using System.Web;
7 using System.Web.Security;
8 using System.Web.UI;
9 using System.Web.UI.HtmlControls;
10 using System.Web.UI.WebControls;
11 using System.Web.UI.WebControls.WebParts;
12 using System.Xml.Linq;
13
14 public partial class RandomNumber : System.Web.UI.Page, System.Web.UI.ICallbackEventHandler
15 {
16 private string _callbackResult = null;
17 protected void Page_Load(object sender, EventArgs e)
18 {
19 if (!IsPostBack)
20 {
21 /*调试输出:
22 cbReference:
23 WebForm_DoCallback('__Page',arg,GetRandomNumberFromServer,context,null,false)
24
25 cbScript:
26 function UseCallback(arg, context){WebForm_DoCallback('__Page',arg,GetRandomNumberFromServer,context,null,false);}
27
28 html中生成的JS:
29 <script type="text/javascript">
30 //<![CDATA[
31 function UseCallback(arg, context)
32 {
33 WebForm_DoCallback('__Page',arg,GetRandomNumberFromServer,context,null,false);
34 }
35 //]]>
36 </script>
37 * */
38
39 /*cbReference 定义接收服务端返回结果的JS函数,即:GetRandomNumberFromServer(可以有n>-1个参数)
40 * this:指定从此发出
41 * arg:指定一个由Asp.Net自动生成的函数(WebForm_DoCallback)的第2个参数名称
42 * context:指定一个由Asp.Net自动生成的函数(WebForm_DoCallback)的第4个参数名称
43 * */
44 string cbReference = Page.ClientScript.
45 GetCallbackEventReference(this, "arg", "GetRandomNumberFromServer", "context");
46
47 /*UseCallback是可供客户端调用的服务器输出的JS函数名称,比如aspx页面有函数A,其中调用了
48 UseCallback函数(可能带有参数)。
49 * */
50 string cbScript = "function UseCallback(arg, context)" +
51 "{" + cbReference + ";}";
52
53 /*
54 * RegisterClientScriptBlock是注册代码到客户端页面,也就是生成一个JS脚本块。
55 * 最后一个参数是说明是否带有“<script type="text/javascript"></script>”标记,一般是true。
56 * */
57 Page.ClientScript.RegisterClientScriptBlock(this.GetType(),
58 "UseCallback", cbScript, true);
59
60
61 //下面为练习(客户端调用带有参数"Jolin")
62 string cbReference2 = Page.ClientScript.GetCallbackEventReference(this, "arg", "GetValueFromServer", "context");
63 string cbScript2 = "function UseServerEvent(arg, context)" +
64 "{" + cbReference2 + ";}";
65 Page.ClientScript.RegisterClientScriptBlock(this.GetType(), "UseServerEvent", cbScript2, true);
66 }
67
68 }
69
70 #region ICallbackEventHandler Members
71
72 public string GetCallbackResult()
73 {
74 return _callbackResult;
75 }
76
77 public void RaiseCallbackEvent(string eventArgument)
78 {
79 if (string.IsNullOrEmpty(eventArgument) || !("Jolin".Equals(eventArgument)))
80 {
81 Random rnd = new Random();
82 _callbackResult = rnd.Next().ToString();
83 }
84 else
85 {
86 _callbackResult = "Jolin, I love you!";
87 }
88 }
89
90 #endregion
91 }

测试结果:

如果点击第一个按钮"Get Random Number"会在其下的输入框中显示一个随机数字,如果点击第二个按钮"Get Return Value"会返回"Jolin, I love you!"。

解释:

上述代码中已经包含了一些解释,下面是针对整个流程,按照自己的理解进行解释,如果有不对的地方,请不吝赐教!

1、客户端直接或者间接调用函数:UseCallback()
而函数UseCallback()是由服务器端动态输出的,里面包含了具有回调功能的函数(具有参数)
2、服务器接收到客户端传递过来的信息,调用ICallbackEventHandler接口的RaiseCallbackEvent(string eventArgument)函数,进行分析(利用eventArgument)和计算,然后通过GetCallbackResult()返回一个string类型值到客户端
3、客户端接收服务器计算结果的函数GetValueFromServer()早已在UseCallback()中被标记,所以会把值传递到GetValueFromServer()函数中,然后赋予HTML控件值,得以显现给用户。

好了,以后还要学习回调的,到时候如果有新的理解,会再来的。

**注:在码字的过程中发现园子的输入控件有点小Bug,如果从外面复制英文状态(带引号)的字符到编辑框,就会出现在其后的中文引号变样,“”->"”“,如果把"去掉就正常了,可能是复制的字符带有格式吧,望高人解答。

风筝

2012.03.29


你可能感兴趣的:(callback)