ClientScriptManager.GetCallbackEventReference 方法

参考

定义

命名空间:: System.Web.UI

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取一个对客户端函数的引用；调用该函数时，将启动一个对服务器事件的客户端回调。

重载

GetCallbackEventReference(Control, String, String, String)	获取一个对客户端函数的引用；调用该函数时，将启动一个对服务器事件的客户端回调。此重载方法的客户端函数包含指定的控件、参数、客户端脚本和上下文。
GetCallbackEventReference(Control, String, String, String, Boolean)	获取一个对客户端函数的引用；调用该函数时，将启动一个对服务器事件的客户端回调。此重载方法的客户端函数包含指定的控件、参数、客户端脚本、上下文和布尔值。
GetCallbackEventReference(String, String, String, String, String, Boolean)	获取一个对客户端函数的引用；调用该函数时，将启动一个对服务器事件的客户端回调。此重载方法的客户端函数包含指定的目标、参数、客户端脚本、上下文、错误处理程序和布尔值。
GetCallbackEventReference(Control, String, String, String, String, Boolean)	获取一个对客户端函数的引用；调用该函数时，将启动一个对服务器事件的客户端回调。此重载方法的客户端函数包含指定的控件、参数、客户端脚本、上下文、错误处理程序和布尔值。

GetCallbackEventReference(Control, String, String, String)

获取一个对客户端函数的引用；调用该函数时，将启动一个对服务器事件的客户端回调。此重载方法的客户端函数包含指定的控件、参数、客户端脚本和上下文。

public:
 System::String ^ GetCallbackEventReference(System::Web::UI::Control ^ control, System::String ^ argument, System::String ^ clientCallback, System::String ^ context);

public string GetCallbackEventReference (System.Web.UI.Control control, string argument, string clientCallback, string context);

member this.GetCallbackEventReference : System.Web.UI.Control * string * string * string -> string

Public Function GetCallbackEventReference (control As Control, argument As String, clientCallback As String, context As String) As String

参数

control: Control

处理客户端回调的服务器 Control。该控件必须实现 ICallbackEventHandler 接口并提供 RaiseCallbackEvent(String) 方法。

argument: String

从客户端脚本传递给服务器的一个参数

RaiseCallbackEvent(String) 方法。

clientCallback: String

一个客户端事件处理程序的名称，该处理程序接收成功的服务器事件的结果。

context: String

启动回调之前在客户端计算的客户端脚本。脚本的结果传回客户端事件处理程序。

String

调用客户端回调的客户端函数的名称。

例外

ArgumentNullException

指定的 Control 为 null。

InvalidOperationException

指定的 Control 未实现 ICallbackEventHandler 接口。

示例

下面的代码示例演示如何在递增整数的客户端回调方案中使用方法的 GetCallbackEventReference 两个重载。

显示了两种回调机制：它们之间的差别在于参数的使用 context 。 ReceiveServerData1使用 context 参数提供客户端回调函数。相比之下， ReceiveServerData2 客户端回调函数是在页面上的块中 <script> 定义的。 RaiseCallbackEvent方法是递增传递给它的值的服务器处理程序，GetCallbackResult该方法以字符串的形式返回递增值。 RaiseCallbackEvent如果方法返回错误，则ProcessCallBackError调用客户端函数。

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    
    public int cbCount = 0;
    
    // Define method that processes the callbacks on server.
    public void RaiseCallbackEvent(String eventArgument)
    {
        cbCount = Convert.ToInt32(eventArgument) + 1;
    }

    // Define method that returns callback result.
    public string GetCallbackResult()
    {
        return cbCount.ToString();
    }

    protected void Page_Load(object sender, EventArgs e)
    {
        // Define a StringBuilder to hold messages to output.
        StringBuilder sb = new StringBuilder();

        // Check if this is a postback.
        sb.Append("No page postbacks have occurred.");
        if (Page.IsPostBack)
        {
            sb.Append("A page postback has occurred.");
        }

        // Write out any messages.
        MyLabel.Text = sb.ToString();

        // Get a ClientScriptManager reference from the Page class.
        ClientScriptManager cs = Page.ClientScript;

        // Define one of the callback script's context.
        // The callback script will be defined in a script block on the page.
        StringBuilder context1 = new StringBuilder();
        context1.Append("function ReceiveServerData1(arg, context)");
        context1.Append("{");
        context1.Append("Message1.innerText =  arg;");
        context1.Append("value1 = arg;");
        context1.Append("}");

        // Define callback references.
        String cbReference1 = cs.GetCallbackEventReference(this, "arg", 
            "ReceiveServerData1", context1.ToString());
        String cbReference2 = cs.GetCallbackEventReference("'" + 
            Page.UniqueID + "'", "arg", "ReceiveServerData2", "", 
            "ProcessCallBackError", false);
        String callbackScript1 = "function CallTheServer1(arg, context) {" + 
            cbReference1 + "; }";
        String callbackScript2 = "function CallTheServer2(arg, context) {" + 
            cbReference2 + "; }";

        // Register script blocks will perform call to the server.
        cs.RegisterClientScriptBlock(this.GetType(), "CallTheServer1", 
            callbackScript1, true);
        cs.RegisterClientScriptBlock(this.GetType(), "CallTheServer2", 
            callbackScript2, true);

    }
</script>

<script type="text/javascript">
var value1 = 0;
var value2 = 0;
function ReceiveServerData2(arg, context)
{
    Message2.innerText = arg;
    value2 = arg;
}
function ProcessCallBackError(arg, context)
{
    Message2.innerText = 'An error has occurred.';
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="Form1" 
          runat="server">
    <div>
      Callback 1 result: <span id="Message1">0</span>
      <br />
      Callback 2 result: <span id="Message2">0</span>
      <br /> <br />
      <input type="button" 
             value="ClientCallBack1" 
             onclick="CallTheServer1(value1, alert('Increment value'))"/>    
      <input type="button" 
             value="ClientCallBack2" 
             onclick="CallTheServer2(value2, alert('Increment value'))"/>
      <br /> <br />
      <asp:Label id="MyLabel" 
                 runat="server"></asp:Label>
    </div>
    </form>
</body>
</html>

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
    Public cbCount As Integer = 0
    
    ' Define method that processes the callbacks on server.
    Public Sub RaiseCallbackEvent(ByVal eventArgument As String) _
    Implements System.Web.UI.ICallbackEventHandler.RaiseCallbackEvent
        
        cbCount = Convert.ToInt32(eventArgument) + 1
        
    End Sub

    ' Define method that returns callback result.
    Public Function GetCallbackResult() _
    As String Implements _
    System.Web.UI.ICallbackEventHandler.GetCallbackResult

        Return cbCount.ToString()
        
    End Function
    
    
 
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    
        ' Define a StringBuilder to hold messages to output.
        Dim sb As New StringBuilder()
    
        ' Check if this is a postback.
        sb.Append("No page postbacks have occurred.")
        If (Page.IsPostBack) Then
      
            sb.Append("A page postback has occurred.")
      
        End If
    
        ' Write out any messages.
        MyLabel.Text = sb.ToString()
    
        ' Get a ClientScriptManager reference from the Page class.
        Dim cs As ClientScriptManager = Page.ClientScript

        ' Define one of the callback script's context.
        ' The callback script will be defined in a script block on the page.
        Dim context1 As New StringBuilder()
        context1.Append("function ReceiveServerData1(arg, context)")
        context1.Append("{")
        context1.Append("Message1.innerText =  arg;")
        context1.Append("value1 = arg;")
        context1.Append("}")
    
        ' Define callback references.
        Dim cbReference1 As String = cs.GetCallbackEventReference(Me, "arg", _
            "ReceiveServerData1", context1.ToString())
        Dim cbReference2 As String = cs.GetCallbackEventReference("'" & _
            Page.UniqueID & "'", "arg", "ReceiveServerData2", "", "ProcessCallBackError", False)
        Dim callbackScript1 As String = "function CallTheServer1(arg, context) {" + _
            cbReference1 + "; }"
        Dim callbackScript2 As String = "function CallTheServer2(arg, context) {" + _
            cbReference2 + "; }"
    
        ' Register script blocks will perform call to the server.
        cs.RegisterClientScriptBlock(Me.GetType(), "CallTheServer1", _
            callbackScript1, True)
        cs.RegisterClientScriptBlock(Me.GetType(), "CallTheServer2", _
            callbackScript2, True)
    
    End Sub
</script>

<script type="text/javascript">
var value1 = 0;
var value2 = 0;
function ReceiveServerData2(arg, context)
{
    Message2.innerText = arg;
    value2 = arg;
}
function ProcessCallBackError(arg, context)
{
    Message2.innerText = 'An error has occurred.';
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="Form1" 
          runat="server">
    <div>
      Callback 1 result: <span id="Message1">0</span>
      <br />
      Callback 2 result: <span id="Message2">0</span>
      <br /> <br />
      <input type="button" 
             value="ClientCallBack1" 
             onclick="CallTheServer1(value1, alert('Increment value'))"/>    
      <input type="button" 
             value="ClientCallBack2" 
             onclick="CallTheServer2(value2, alert('Increment value'))"/>
      <br /> <br />
      <asp:Label id="MyLabel" 
                 runat="server"></asp:Label>
    </div>
    </form>
</body>
</html>

注解

方法 GetCallbackEventReference(Control, String, String, String) 对服务器执行带外回调，该回调是页面正常生命周期的修改版本。有关详细信息，请参阅实现不带回发的客户端回调。

注意

当浏览器为 Microsoft Internet Explorer (版本 5.0 或更高版本) 时，脚本回调机制通过 Microsoft.XmlHttp COM 对象实现，并要求将浏览器设置为运行 ActiveX 控件。对于其他浏览器，使用浏览器的本地文档对象模型 (DOM) 的 XMLHttpRequest。若要检查浏览器是否支持客户端回调，请使用 SupportsCallback 属性。若要检查浏览器是否支持基于 HTTP 的 XML，请使用 SupportsXmlHttp 属性。这两个属性都可以通过 Browser 内部 ASP.NET Request 对象的属性进行访问。

方法 GetCallbackEventReference 的 GetCallbackEventReference 重载使用 XML over HTTP 同步执行回调。在回调方案中同步发送数据时，同步回调会立即返回，并且不会阻止浏览器。浏览器中不能同时执行两个同步回调回调。如果在第一个同步回调当前挂起时触发第二个同步回调，则第二个同步回调将取消第一个回调，只有第二个回调将返回。

若要异步发送数据，请使用采用 useAsync 参数的重载之一，该重载是控制此行为的布尔值。在异步方案中，可以有多个挂起的回调;但是，不能保证它们返回的顺序与启动顺序匹配。

此外，方法的 GetCallbackEventReference 此重载指定没有客户端函数来处理方法生成的 RaiseCallbackEvent 错误条件的情况。若要指定客户端错误回调处理程序，请使用采用 clientErrorCallback 参数的重载之一。

方法 GetCallbackEventReference(Control, String, String, String) 采用可选的字符串 argument 参数并返回字符串。若要传入或接收多个值，请分别连接输入或返回字符串中的值。

注意

避免在实现在脚本回调操作期间需要更新的页或控件属性中使用视图状态。如果属性在页面请求中幸存下来，则可以使用会话状态。

另请参阅

适用于

GetCallbackEventReference(Control, String, String, String, Boolean)

获取一个对客户端函数的引用；调用该函数时，将启动一个对服务器事件的客户端回调。此重载方法的客户端函数包含指定的控件、参数、客户端脚本、上下文和布尔值。

public:
 System::String ^ GetCallbackEventReference(System::Web::UI::Control ^ control, System::String ^ argument, System::String ^ clientCallback, System::String ^ context, bool useAsync);

public string GetCallbackEventReference (System.Web.UI.Control control, string argument, string clientCallback, string context, bool useAsync);

member this.GetCallbackEventReference : System.Web.UI.Control * string * string * string * bool -> string

Public Function GetCallbackEventReference (control As Control, argument As String, clientCallback As String, context As String, useAsync As Boolean) As String

参数

control: Control

处理客户端回调的服务器 Control。该控件必须实现 ICallbackEventHandler 接口并提供 RaiseCallbackEvent(String) 方法。

argument: String

从客户端脚本传递给服务器的一个参数

RaiseCallbackEvent(String) 方法。

clientCallback: String

一个客户端事件处理程序的名称，该处理程序接收成功的服务器事件的结果。

context: String

启动回调之前在客户端计算的客户端脚本。脚本的结果传回客户端事件处理程序。

useAsync: Boolean

true 表示异步执行回调；false 表示同步执行回调。

String

调用客户端回调的客户端函数的名称。

例外

ArgumentNullException

指定的 Control 为 null。

InvalidOperationException

指定的 Control 未实现 ICallbackEventHandler 接口。

注解

方法的 GetCallbackEventReference 此重载需要参数 useAsync ，该参数允许通过将值设置为 true来异步执行客户端回调。此方法不需要参数的 useAsync 重载版本默认将值设置为 false 。

有关此方法的详细信息，请参阅重载 GetCallbackEventReference 方法的备注。

另请参阅

适用于

GetCallbackEventReference(String, String, String, String, String, Boolean)

获取一个对客户端函数的引用；调用该函数时，将启动一个对服务器事件的客户端回调。此重载方法的客户端函数包含指定的目标、参数、客户端脚本、上下文、错误处理程序和布尔值。

public:
 System::String ^ GetCallbackEventReference(System::String ^ target, System::String ^ argument, System::String ^ clientCallback, System::String ^ context, System::String ^ clientErrorCallback, bool useAsync);

public string GetCallbackEventReference (string target, string argument, string clientCallback, string context, string clientErrorCallback, bool useAsync);

member this.GetCallbackEventReference : string * string * string * string * string * bool -> string

Public Function GetCallbackEventReference (target As String, argument As String, clientCallback As String, context As String, clientErrorCallback As String, useAsync As Boolean) As String

参数

target: String

处理客户端回调的服务器 Control 的名称。该控件必须实现 ICallbackEventHandler 接口并提供 RaiseCallbackEvent(String) 方法。

argument: String

从客户端脚本传递给服务器的一个参数

RaiseCallbackEvent(String) 方法。

clientCallback: String

一个客户端事件处理程序的名称，该处理程序接收成功的服务器事件的结果。

context: String

启动回调之前在客户端计算的客户端脚本。脚本的结果传回客户端事件处理程序。

clientErrorCallback: String

客户端事件处理程序的名称，该处理程序在服务器端事件处理程序出现错误时接收结果。

useAsync: Boolean

true 表示异步执行回调；false 表示同步执行回调。

String

调用客户端回调的客户端函数的名称。

示例

下面的代码示例演示如何在递增整数的客户端回调方案中使用方法的 GetCallbackEventReference 两个重载。

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    
    public int cbCount = 0;
    
    // Define method that processes the callbacks on server.
    public void RaiseCallbackEvent(String eventArgument)
    {
        cbCount = Convert.ToInt32(eventArgument) + 1;
    }

    // Define method that returns callback result.
    public string GetCallbackResult()
    {
        return cbCount.ToString();
    }

    protected void Page_Load(object sender, EventArgs e)
    {
        // Define a StringBuilder to hold messages to output.
        StringBuilder sb = new StringBuilder();

        // Check if this is a postback.
        sb.Append("No page postbacks have occurred.");
        if (Page.IsPostBack)
        {
            sb.Append("A page postback has occurred.");
        }

        // Write out any messages.
        MyLabel.Text = sb.ToString();

        // Get a ClientScriptManager reference from the Page class.
        ClientScriptManager cs = Page.ClientScript;

        // Define one of the callback script's context.
        // The callback script will be defined in a script block on the page.
        StringBuilder context1 = new StringBuilder();
        context1.Append("function ReceiveServerData1(arg, context)");
        context1.Append("{");
        context1.Append("Message1.innerText =  arg;");
        context1.Append("value1 = arg;");
        context1.Append("}");

        // Define callback references.
        String cbReference1 = cs.GetCallbackEventReference(this, "arg", 
            "ReceiveServerData1", context1.ToString());
        String cbReference2 = cs.GetCallbackEventReference("'" + 
            Page.UniqueID + "'", "arg", "ReceiveServerData2", "", 
            "ProcessCallBackError", false);
        String callbackScript1 = "function CallTheServer1(arg, context) {" + 
            cbReference1 + "; }";
        String callbackScript2 = "function CallTheServer2(arg, context) {" + 
            cbReference2 + "; }";

        // Register script blocks will perform call to the server.
        cs.RegisterClientScriptBlock(this.GetType(), "CallTheServer1", 
            callbackScript1, true);
        cs.RegisterClientScriptBlock(this.GetType(), "CallTheServer2", 
            callbackScript2, true);

    }
</script>

<script type="text/javascript">
var value1 = 0;
var value2 = 0;
function ReceiveServerData2(arg, context)
{
    Message2.innerText = arg;
    value2 = arg;
}
function ProcessCallBackError(arg, context)
{
    Message2.innerText = 'An error has occurred.';
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="Form1" 
          runat="server">
    <div>
      Callback 1 result: <span id="Message1">0</span>
      <br />
      Callback 2 result: <span id="Message2">0</span>
      <br /> <br />
      <input type="button" 
             value="ClientCallBack1" 
             onclick="CallTheServer1(value1, alert('Increment value'))"/>    
      <input type="button" 
             value="ClientCallBack2" 
             onclick="CallTheServer2(value2, alert('Increment value'))"/>
      <br /> <br />
      <asp:Label id="MyLabel" 
                 runat="server"></asp:Label>
    </div>
    </form>
</body>
</html>

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
    Public cbCount As Integer = 0
    
    ' Define method that processes the callbacks on server.
    Public Sub RaiseCallbackEvent(ByVal eventArgument As String) _
    Implements System.Web.UI.ICallbackEventHandler.RaiseCallbackEvent
        
        cbCount = Convert.ToInt32(eventArgument) + 1
        
    End Sub

    ' Define method that returns callback result.
    Public Function GetCallbackResult() _
    As String Implements _
    System.Web.UI.ICallbackEventHandler.GetCallbackResult

        Return cbCount.ToString()
        
    End Function
    
    
 
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    
        ' Define a StringBuilder to hold messages to output.
        Dim sb As New StringBuilder()
    
        ' Check if this is a postback.
        sb.Append("No page postbacks have occurred.")
        If (Page.IsPostBack) Then
      
            sb.Append("A page postback has occurred.")
      
        End If
    
        ' Write out any messages.
        MyLabel.Text = sb.ToString()
    
        ' Get a ClientScriptManager reference from the Page class.
        Dim cs As ClientScriptManager = Page.ClientScript

        ' Define one of the callback script's context.
        ' The callback script will be defined in a script block on the page.
        Dim context1 As New StringBuilder()
        context1.Append("function ReceiveServerData1(arg, context)")
        context1.Append("{")
        context1.Append("Message1.innerText =  arg;")
        context1.Append("value1 = arg;")
        context1.Append("}")
    
        ' Define callback references.
        Dim cbReference1 As String = cs.GetCallbackEventReference(Me, "arg", _
            "ReceiveServerData1", context1.ToString())
        Dim cbReference2 As String = cs.GetCallbackEventReference("'" & _
            Page.UniqueID & "'", "arg", "ReceiveServerData2", "", "ProcessCallBackError", False)
        Dim callbackScript1 As String = "function CallTheServer1(arg, context) {" + _
            cbReference1 + "; }"
        Dim callbackScript2 As String = "function CallTheServer2(arg, context) {" + _
            cbReference2 + "; }"
    
        ' Register script blocks will perform call to the server.
        cs.RegisterClientScriptBlock(Me.GetType(), "CallTheServer1", _
            callbackScript1, True)
        cs.RegisterClientScriptBlock(Me.GetType(), "CallTheServer2", _
            callbackScript2, True)
    
    End Sub
</script>

<script type="text/javascript">
var value1 = 0;
var value2 = 0;
function ReceiveServerData2(arg, context)
{
    Message2.innerText = arg;
    value2 = arg;
}
function ProcessCallBackError(arg, context)
{
    Message2.innerText = 'An error has occurred.';
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="Form1" 
          runat="server">
    <div>
      Callback 1 result: <span id="Message1">0</span>
      <br />
      Callback 2 result: <span id="Message2">0</span>
      <br /> <br />
      <input type="button" 
             value="ClientCallBack1" 
             onclick="CallTheServer1(value1, alert('Increment value'))"/>    
      <input type="button" 
             value="ClientCallBack2" 
             onclick="CallTheServer2(value2, alert('Increment value'))"/>
      <br /> <br />
      <asp:Label id="MyLabel" 
                 runat="server"></asp:Label>
    </div>
    </form>
</body>
</html>

注解

方法的 GetCallbackEventReference 此重载采用 target 字符串参数而不是 Control 参数。如果希望回调返回到包含 UniqueID 控件的字符串以外的其他内容，请使用此重载。

此外，此方法的 GetCallbackEventReference 此重载需要 useAsync 和 clientErrorCallback 参数。参数 useAsync 允许通过将值设置为 true来异步执行客户端回调。此方法不需要参数的 useAsync 重载版本默认将值设置为 false 。参数 clientErrorCallback 允许定义在服务器处理程序 RaiseCallbackEvent 方法返回错误时调用的客户端函数的名称。此方法 clientErrorCallback 不需要参数的重载版本将值设置为 null。

有关此方法的详细信息，请参阅重载 GetCallbackEventReference 方法的备注。

另请参阅

适用于

GetCallbackEventReference(Control, String, String, String, String, Boolean)

获取一个对客户端函数的引用；调用该函数时，将启动一个对服务器事件的客户端回调。此重载方法的客户端函数包含指定的控件、参数、客户端脚本、上下文、错误处理程序和布尔值。

public:
 System::String ^ GetCallbackEventReference(System::Web::UI::Control ^ control, System::String ^ argument, System::String ^ clientCallback, System::String ^ context, System::String ^ clientErrorCallback, bool useAsync);

public string GetCallbackEventReference (System.Web.UI.Control control, string argument, string clientCallback, string context, string clientErrorCallback, bool useAsync);

member this.GetCallbackEventReference : System.Web.UI.Control * string * string * string * string * bool -> string

Public Function GetCallbackEventReference (control As Control, argument As String, clientCallback As String, context As String, clientErrorCallback As String, useAsync As Boolean) As String

参数

control: Control

处理客户端回调的服务器 Control。该控件必须实现 ICallbackEventHandler 接口并提供 RaiseCallbackEvent(String) 方法。

argument: String

从客户端脚本传递给服务器的 RaiseCallbackEvent(String) 方法的参数。

clientCallback: String

一个客户端事件处理程序的名称，该处理程序接收成功的服务器事件的结果。

context: String

启动回调之前在客户端计算的客户端脚本。脚本的结果传回客户端事件处理程序。

clientErrorCallback: String

客户端事件处理程序的名称，该处理程序在服务器端事件处理程序出现错误时接收结果。

useAsync: Boolean

true 表示异步执行回调；false 表示同步执行回调。

String

调用客户端回调的客户端函数的名称。

例外

ArgumentNullException

指定的 Control 为 null。

InvalidOperationException

指定的 Control 未实现 ICallbackEventHandler 接口。

注解

方法的 GetCallbackEventReference 此重载需要 useAsync 和 clientErrorCallback 参数。参数 useAsync 允许通过将值设置为 true来异步执行客户端回调。此方法不需要参数的 useAsync 重载版本默认将值设置为 false 。参数 clientErrorCallback 允许定义当服务器处理程序 (RaiseCallbackEvent 方法) 返回错误时调用的客户端函数的名称。此方法 clientErrorCallback 不需要参数的重载版本将值设置为 null。

有关此方法的详细信息，请参阅重载 GetCallbackEventReference 方法的备注。

另请参阅

适用于

通过

ClientScriptManager.GetCallbackEventReference 方法

定义

重载

GetCallbackEventReference(Control, String, String, String)

参数

返回

例外

示例

注解

另请参阅

适用于

GetCallbackEventReference(Control, String, String, String, Boolean)

参数

返回

例外

注解

另请参阅

适用于

GetCallbackEventReference(String, String, String, String, String, Boolean)

参数

返回

示例

注解

另请参阅

适用于

GetCallbackEventReference(Control, String, String, String, String, Boolean)

参数

返回

例外

注解

另请参阅

适用于

其他资源