在 ASP.NET 网页的默认模型中,单击按钮或执行导致回发的一些其他操作。此时将重新创建页及其控件,并在服务器上运行页代码,然后返回给浏览器,并呈现出来。但是,在有些情况下,需要从客户端运行服务器代码,而不执行回发。如果页中的客户端脚本维护一些状态信息(例如,局部变量值),那么发送页和获取页的新副本就会损坏该状态。此外,页回发会导致处理开销,这会降低性能,且会让用户不得不等待处理并重新创建页。若要避免丢失客户端状态并且不导致服务器往返的处理开销,可以对 ASP.NET 网页编码,使其能执行客户端回调。在客户端回调中,客户端脚本函数会向 ASP.NET 网页发送一个请求。该网页运行其正常生命周期的修改版本 — 初始化页并创建其控件和其他成员,然后调用特别标记的方法。该方法执行代码中编写的处理过程,然后向浏览器返回可由另一客户端脚本函数读取的值。在此过程中,该页一直驻留在浏览器中。
客户端回调组件创建实现客户端回调的 ASP.NET 页与创建任何 ASP.NET 页类似,但也有如下这些区别。页的服务器代码必须:
  • 实现 ICallbackEventHandler 接口。可以向任何 ASP.NET 网页添加此接口声明。
  • 提供 RaiseCallbackEvent 方法的实现。此方法将被调用以对服务器执行回调。
  • 提供 GetCallbackResult 方法的实现。此方法会将回调结果返回给客户端。
此外,该页还必须包含执行以下操作的三个客户端脚本函数:
  • 一个函数调用帮助器方法,该方法执行对服务器的实际请求。在此函数中,可以首先执行自定义逻辑以准备事件参数,然后可以将一个字符串作为参数发送到服务器端回调事件处理程序。
  • 另一个函数由处理回调事件的服务器代码的结果调用并接收该结果,同时接受表示该结果的字符串。该函数称为客户端回调函数。
  • 第三个函数是执行对服务器的实际请求的 Helper 函数,当在服务器代码中使用 GetCallbackEventReference 方法生成对此函数的引用时,由 ASP.NET 自动生成该函数。

GetCallBackEventReferenceTest.aspx.cs:

using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using System.Text;

public
partial
class MiniSample_GetCallbackEventReferenceTest :

System.Web.UI.Page,ICallbackEventHandler
{
   
public
double cbCount =
0;

   
protected
void Page_Load(object sender, EventArgs e)
   
{
        ClientScriptManager cs
= Page.ClientScript;

//获取一个对客户端函数的引用;调用该函数时,将启动一个对服务器端事件的客户端回调。通过调用页的 GetCallbackEventReference 方法可以获取对库函数的引用,该方法可通过页 ClientScript 属性进行访问。然后动态生成一个客户端函数,该函数包含对来自 GetCallbackEventReference 方法的返回值的调用。
//ClientScriptManager.GetCallbackEventReference 方法的使用请查看。http://msdn2.microsoft.com/zh-cn/library/system.web.ui.clientscriptmanager.getcallbackeventreference(VS.80).aspx
//arg+'|'+context是传递给服务端的函数,由于要传入多参数,故用|连接起来,

ReceiveServerData是一个客户端方法接受服务端返回的值,GetBoxValueAndSum是在调用服务端方法之前所调用的客户端方法,ProcessCallBackError当服务端函数出错时,执行这客服端方法。
        String cbReference
= cs.GetCallbackEventReference(this, "arg+'|'+context","ReceiveServerData","GetBoxValueAndSum", "ProcessCallBackError", false);

//CallTheServer此客户端函数作用是用来调用服务器端方法
        String callbackScript =
"function CallTheServer(arg, context) {"
+cbReference +
"; }";

       
// 注册脚本块,以客户端方法调用服务器端方法
        cs.RegisterClientScriptBlock(this.GetType(), "CallTheServer",callbackScript,true);
    }


   
// 回调服务器端处理函数

public
void RaiseCallbackEvent(String eventArgument)
   
{
       
string[] data = eventArgument.Split('|');//“|”分割
//判断运算符

switch (data[2])
       
{
           
case
"+":
                cbCount
= Convert.ToDouble(data[0]) + Convert.ToDouble(data[1]);
               
break;
           
case
"-":
                cbCount
= Convert.ToDouble(data[0]) - Convert.ToDouble(data[1]);
               
break;
           
default:
               
break;
        }

    }


   
// 回调结果,返回给客户端

public
string GetCallbackResult()
   
{
       
return cbCount.ToString();
    }

}





GetCallbackEventReferenceTest.aspx:
<%@ Page Language="C#" AutoEventWireup="true"

CodeFile
="GetCallbackEventReferenceTest.aspx.cs"

Inherits
="MiniSample_GetCallbackEventReferenceTest"
%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"
>

<html xmlns="http://www.w3.org/1999/xhtml"
>
<head runat="server">
   
<title>无标题页</title>
   
<script type="text/javascript">
   
function ProcessCallBackError(arg, context)
   
{
        Message2.innerText
=
'错误:'+arg;//服务器端出错时,显示错误信息
    }
   
//调用服务器端方法之前处理一些请求

function GetBoxValueAndSum(mth)
   
{
        GetMethod(mth);
       
var value1 = document.getElementById("Num1").value;
       
var value2 = document.getElementById("Num2").value;
       
var value = value1+"|"+value2;
        CallTheServer2(value,mth);
//客户端调用服务端方法
    }
   
function ReceiveServerData2(arg, context)
   
{
        Message1.innerText
= arg;//接受回调函数返回的值
    }

   
function GetMethod(mt)
   
{
        document.getElementById(
"Method").innerText=mt;
    }

   
</script>

</head>
<body>
   
<form id="form1" runat="server">
   
<div id="txtNum">
       
<input id="Num1" type="text"
/><span id="Method"></span>
       
<input id="Num2" type="text"
/>=<span id="Message1">0</span>
     
<br />
     
<input type="button"
            value
="客户端回调1(加法)"
            onclick
="GetBoxValueAndSum('+')"/>
           
     
<input type="button"
            value
="客户端回调2(减法)"
            onclick
="GetBoxValueAndSum('-')"/>
     
<br />
     
<asp:Label id="MyLabel"
                runat
="server"></asp:Label><br />
               
<span id="Message2"></span>
   
</div>
   
</form>
</body>
</html>