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 属性。可通过内部 ASP.NET Request 对象的属性访问Browser这两个属性。

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

若要异步发送数据，请使用采用 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)

参数

返回

例外

注解

另请参阅

适用于

其他资源