在 ASP.NET 网页中不经过回发而以编程方式实现客户端回调

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

在 ASP.NET 网页的默认模型中，用户会与页交互，单击按钮或执行导致回发的一些其他操作。此时将重新创建页及其控件，并在服务器上运行页代码，且新版本的页被呈现到浏览器。但是，在有些情况下，需要从客户端运行服务器代码，而不执行回发。如果页中的客户端脚本维护一些状态信息（例如，局部变量值），那么发送页和获取页的新副本就会损坏该状态。此外，页回发会导致处理开销，这会降低性能，且会让用户不得不等待处理并重新创建页。

若要避免丢失客户端状态并且不导致服务器往返的处理开销，可以对 ASP.NET 网页编码，使其能执行客户端回调。在客户端回调中，客户端脚本函数会向 ASP.NET 网页发送一个请求。该网页将以正常生命周期的修改版本运行。这会启动该页并创建其控件和其他成员，然后调用一个特别标记的方法。该方法执行代码中编写的处理过程，然后向浏览器返回可由另一客户端脚本函数读取的值。在此过程中，该页一直驻留在浏览器中。

有几个 Web 服务器控件可以使用客户端回调。例如，TreeView 控件使用客户端回调实现其即需填充功能。有关更多信息，请参见 TreeView Web 服务器控件概述。

在 ASP.NET 网页中，有一些选项可用于自动处理客户端回调。ASP.NET 中的 AJAX 功能（例如 UpdatePanel 服务器控件）可自动完成异步部分页更新，其 Web 服务通信功能可自动完成异步 Web 服务调用。

有关 ASP.NET 中可自动处理客户端回调的 AJAX 功能的概述，请参见以下主题：

UpdatePanel 控件概述
ASP.NET AJAX 概述
部分页呈现概述
ASP.NET AJAX 中的 Web 服务

您也可以编写自己的客户端脚本来直接实现客户端回调。本主题讨论如何实现自己的客户端回调，以便在客户端与服务器之间进行异步通信。

客户端回调组件

创建以编程方式实现客户端回调的 ASP.NET 页与创建任何 ASP.NET 页的过程类似，但也存在下列区别。该页的服务器代码必须执行下列任务：

实现 ICallbackEventHandler 接口。可以向任何 ASP.NET 网页添加此接口声明。
提供 RaiseCallbackEvent 方法的实现。此方法将被调用以对服务器执行回调。
提供 GetCallbackResult 方法的实现。此方法会将回调结果返回给客户端。

此外，该页还必须包含执行以下操作的三个客户端脚本函数：

一个函数调用帮助器方法，该方法执行对服务器的实际请求。在此函数中，可以执行自定义逻辑，以最先准备事件实参。您可以将字符串作为形参发送给服务器端的回调事件处理程序。
另一个函数由处理回调事件的服务器代码的结果调用并接收该结果，同时接受表示该结果的字符串。此函数称为客户端回调函数。
第三个函数是执行实际服务器请求的 Helper 函数。当在服务器代码中使用 GetCallbackEventReference 方法生成对此函数的引用时，ASP.NET 将自动生成此函数。

客户端回调和回发都是针对原始页面的请求。因此，它们在 Web 服务器日志中被记录为页面请求。

在服务器代码中实现所需的接口

若要从客户端脚本中运行服务器代码而不执行回发，必须在服务器代码中实现一些接口。

声明 ICallbackEventHandler 接口

可以将 ICallbackEventHandler 接口作为页的类声明的一部分进行声明。如果创建代码隐藏页，则可以通过使用如下语法声明该接口。

public partial class CallBack_DB_aspx :
System.Web.UI.Page, System.Web.UI.ICallbackEventHandler

如果正在处理单文件页或用户控件，则可以通过在页中使用 @ Implements 指令来添加声明，如下面的示例所示：

<%@ Page Language="C#" %>
<%@ Implements Interface="System.Web.UI.ICallbackEventHandler" %>

说明：
接口名区分大小写。

创建服务器回调方法

在服务器代码中，必须创建一个实现 RaiseCallbackEvent 方法的方法和一个实现 GetCallbackResult 方法的方法。RaiseCallbackEvent 方法接受单个字符串参数，而不是通常用于事件处理程序的常见的两个参数。该方法的部分内容可能与下面的示例类似：

public void RaiseCallbackEvent(String eventArgument)
{}

GetCallbackResult 不接受参数并返回一个字符串。该方法的部分内容可能与下面的示例类似：

public string GetCallbackResult()
{
return aStringValue;
}

创建客户端脚本函数

必须向页中添加客户端脚本函数才能执行两个功能：向服务器页发送回调和接收结果。这两个客户端脚本函数都是用 ECMAScript (JavaScript) 编写。

发送回调

发送回调的函数在服务器代码中生成。实际回调由任何页都可使用的、实现 ICallbackEventHandler 接口的库函数执行。通过调用页的 GetCallbackEventReference 方法可以获取对库函数的引用，该方法可通过页 ClientScript 属性进行访问。然后动态生成一个客户端函数，该函数包含对来自 GetCallbackEventReference 方法的返回值的调用。应向该方法传递以下内容：一个对页的引用（在 C# 中为 this，在 Visual Basic 中为 this）、传递数据时所使用的参数名称、将接收回调数据的客户端脚本函数的名称，以及传递所需的任何上下文的参数。

生成函数之后，通过调用 RegisterClientScriptBlock 方法将其插入到页中。

下面的示例演示如何以动态方式创建一个名为 CallServer 且调用回调的函数。

void Page_Load(object sender, EventArgs e)
{
ClientScriptManager cm = Page.ClientScript;
String cbReference = cm.GetCallbackEventReference(this, "arg",
"ReceiveServerData", "");
String callbackScript = "function CallServer(arg, context) {" +
cbReference + "; }";
cm.RegisterClientScriptBlock(this.GetType(),
"CallServer", callbackScript, true);
}

由正在生成的函数接受的参数名称应与传递给 GetCallbackEventReference 方法的值的名称相匹配。

下面的示例演示一些可用于调用回调并处理其返回值的标记：