ClientScriptManager.GetCallbackEventReference Método

  • Referencia

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.dll

Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a un evento de servidor.

Sobrecargas

GetCallbackEventReference(Control, String, String, String)

Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a un evento de servidor. La función de cliente para este método sobrecargado incluye un control, un argumento, un script de cliente y un contexto especificados.
GetCallbackEventReference(Control, String, String, String, Boolean)

Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a los eventos de servidor. La función de cliente para este método sobrecargado incluye un control, un argumento, un script de cliente, un contexto y un valor booleano especificados.
GetCallbackEventReference(String, String, String, String, String, Boolean)

Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a los eventos de servidor. La función de cliente para este método sobrecargado incluye un destino, un argumento, un script de cliente, un contexto, un controlador de errores y un valor booleano especificados.
GetCallbackEventReference(Control, String, String, String, String, Boolean)

Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a los eventos de servidor. La función de cliente para este método sobrecargado incluye un control, un argumento, un script de cliente, un contexto, un controlador de errores y un valor booleano especificados.

GetCallbackEventReference(Control, String, String, String)

Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a un evento de servidor. La función de cliente para este método sobrecargado incluye un control, un argumento, un script de cliente y un contexto especificados.

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

Parámetros

control
Control

Objeto Control de servidor que controla la devolución de llamada de cliente. El control debe implementar la interfaz ICallbackEventHandler y proporcionar un método RaiseCallbackEvent(String).

argument
String

Argumento pasado desde el script de cliente al de servidor

Método RaiseCallbackEvent(String).

clientCallback
String

Nombre del controlador de eventos de cliente que recibe el resultado de un evento de servidor correcto.

context
String

El script de cliente que se evalúa en el cliente antes de iniciar la devolución de llamada. El resultado del script se devuelve al controlador de eventos de cliente.

Devoluciones

String

El nombre de una función de cliente que invoca la devolución de llamada de cliente.

Excepciones

ArgumentNullException

El Control especificado es null.

InvalidOperationException

El objeto Control no implementa la interfaz ICallbackEventHandler.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar dos sobrecargas del GetCallbackEventReference método en un escenario de devolución de llamada de cliente que incrementa enteros.

Se muestran dos mecanismos de devolución de llamada; la diferencia entre ellos es el uso del context parámetro . Se proporciona una ReceiveServerData1 función de devolución de llamada de cliente mediante el context parámetro . En cambio, la ReceiveServerData2 función de devolución de llamada del cliente se define en un <script> bloque de la página. Un RaiseCallbackEvent método es el controlador de servidor que incrementa el valor que se le pasa y el GetCallbackResult método devuelve el valor incrementado como una cadena. Si el RaiseCallbackEvent método devuelve un error, se llama a la ProcessCallBackError función cliente.

<%@ 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>

Comentarios

El GetCallbackEventReference(Control, String, String, String) método realiza una devolución de llamada fuera de banda en el servidor que es una versión modificada del ciclo de vida normal de una página. Para obtener más información, vea Implementación de devoluciones de llamada de cliente sin postbacks.

Nota:

Cuando el explorador se Microsoft Internet Explorer (versión 5.0 o posterior), el mecanismo de devolución de llamada del script se implementa a través del Microsoft. El objeto COM XmlHttp y requiere que el explorador se establezca para ejecutar controles ActiveX. Para otros exploradores, se usa un XMLHttpRequest mediante el modelo de objetos de documento (DOM) local del explorador. Para comprobar si un explorador admite devoluciones de llamada de cliente, use la SupportsCallback propiedad . Para comprobar si un explorador admite XML a través de HTTP, use la SupportsXmlHttp propiedad . Se puede acceder a ambas propiedades a través de la Browser propiedad del objeto intrínseco ASP.NET Request .

La GetCallbackEventReference sobrecarga del GetCallbackEventReference método realiza una devolución de llamada de forma sincrónica mediante XML a través de HTTP. Al enviar datos de forma sincrónica en un escenario de devolución de llamada, las devoluciones de llamada sincrónicas devuelven inmediatamente y no bloquean el explorador. No se pueden ejecutar dos devoluciones de llamada sincrónicas al mismo tiempo en el explorador. Si se desencadena una segunda devolución de llamada sincrónica mientras uno está pendiente actualmente, la segunda devolución de llamada sincrónica cancela la primera y solo se devolverá la segunda devolución de llamada.

Para enviar datos de forma asincrónica, use una de las sobrecargas que toma el useAsync parámetro , que es un valor booleano que controla este comportamiento. En el escenario asincrónico, puede tener varias devoluciones de llamada pendientes; sin embargo, no se garantiza que el orden en el que devuelvan coincida con el orden en el que se iniciaron.

Además, esta sobrecarga del GetCallbackEventReference método no especifica ninguna función de cliente para controlar el caso de una condición de error generada por el RaiseCallbackEvent método . Para especificar un controlador de devolución de llamada de error de cliente, use una de las sobrecargas que toma el clientErrorCallback parámetro .

El GetCallbackEventReference(Control, String, String, String) método toma un parámetro de cadena argument opcional y devuelve una cadena. Para pasar o recibir varios valores, concatene los valores en la cadena de entrada o devolución, respectivamente.

Nota

Evite usar el estado de vista en la implementación de propiedades de página o control que se deben actualizar durante las operaciones de devolución de llamada de script. Si las propiedades son para sobrevivir a las solicitudes de página, puede usar el estado de sesión.

Consulte también

Se aplica a

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

Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a los eventos de servidor. La función de cliente para este método sobrecargado incluye un control, un argumento, un script de cliente, un contexto y un valor booleano especificados.

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

Parámetros

control
Control

Objeto Control de servidor que controla la devolución de llamada de cliente. El control debe implementar la interfaz ICallbackEventHandler y proporcionar un método RaiseCallbackEvent(String).

argument
String

Argumento pasado desde el script de cliente al de servidor

Método RaiseCallbackEvent(String).

clientCallback
String

Nombre del controlador de eventos de cliente que recibe el resultado de un evento de servidor correcto.

context
String

El script de cliente que se evalúa en el cliente antes de iniciar la devolución de llamada. El resultado del script se devuelve al controlador de eventos de cliente.

useAsync
Boolean

Es true para realizar la devolución de llamada de forma asincrónica; es false para realizar la devolución de llamada de forma sincrónica.

Devoluciones

String

El nombre de una función de cliente que invoca la devolución de llamada de cliente.

Excepciones

ArgumentNullException

El Control especificado es null.

InvalidOperationException

El objeto Control no implementa la interfaz ICallbackEventHandler.

Comentarios

Esta sobrecarga del GetCallbackEventReference método requiere un useAsync parámetro , que permite realizar la devolución de llamada de cliente de forma asincrónica estableciendo el valor en true. Las versiones de sobrecarga de este método que no requieren el useAsync parámetro establecen el valor false en de forma predeterminada.

Para obtener más información sobre este método, vea los comentarios del método de sobrecarga GetCallbackEventReference .

Consulte también

Se aplica a

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

Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a los eventos de servidor. La función de cliente para este método sobrecargado incluye un destino, un argumento, un script de cliente, un contexto, un controlador de errores y un valor booleano especificados.

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

Parámetros

target
String

Nombre de un servidor Control que controla la devolución de llamada del cliente. El control debe implementar la interfaz ICallbackEventHandler y proporcionar un método RaiseCallbackEvent(String).

argument
String

Argumento pasado desde el script de cliente al de servidor

Método RaiseCallbackEvent(String).

clientCallback
String

Nombre del controlador de eventos de cliente que recibe el resultado de un evento de servidor correcto.

context
String

El script de cliente que se evalúa en el cliente antes de iniciar la devolución de llamada. El resultado del script se devuelve al controlador de eventos de cliente.

clientErrorCallback
String

Nombre del controlador de eventos de cliente que recibe el resultado cuando se produce un error en el controlador de eventos de servidor.

useAsync
Boolean

Es true para realizar la devolución de llamada de forma asincrónica; es false para realizar la devolución de llamada de forma sincrónica.

Devoluciones

String

El nombre de una función de cliente que invoca la devolución de llamada de cliente.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar dos sobrecargas del GetCallbackEventReference método en un escenario de devolución de llamada de cliente que incrementa enteros.

Se muestran dos mecanismos de devolución de llamada; la diferencia entre ellos es el uso del context parámetro . Se proporciona una ReceiveServerData1 función de devolución de llamada de cliente mediante el context parámetro . En cambio, la ReceiveServerData2 función de devolución de llamada del cliente se define en un <script> bloque de la página. Un RaiseCallbackEvent método es el controlador de servidor que incrementa el valor que se le pasa y el GetCallbackResult método devuelve el valor incrementado como una cadena. Si el RaiseCallbackEvent método devuelve un error, se llama a la función ProcessCallBackError cliente.

<%@ 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>

Comentarios

Esta sobrecarga del GetCallbackEventReference método toma un target parámetro de cadena en lugar de un Control parámetro . Use esta sobrecarga cuando desee que la devolución de llamada vuelva a algo distinto de una cadena que contenga el UniqueID del control.

Además, esta sobrecarga del GetCallbackEventReference método requiere un useAsync parámetro y .clientErrorCallback El useAsync parámetro permite realizar la devolución de llamada de cliente de forma asincrónica estableciendo el valor en true. Las versiones de sobrecarga de este método que no requieren el useAsync parámetro establecen el valor false en de forma predeterminada. El clientErrorCallback parámetro permite definir el nombre de la función cliente a la que se llama si el controlador del servidor, el RaiseCallbackEvent método , devuelve un error. Las versiones de sobrecarga de este método que no requieren el clientErrorCallback parámetro establecen el valor en NULL.

Para obtener más información sobre este método, vea los comentarios del método de sobrecarga GetCallbackEventReference .

Consulte también

Se aplica a

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

Obtiene una referencia a una función de cliente que, cuando se invoca, inicia una devolución de llamada del cliente a los eventos de servidor. La función de cliente para este método sobrecargado incluye un control, un argumento, un script de cliente, un contexto, un controlador de errores y un valor booleano especificados.

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

Parámetros

control
Control

Objeto Control de servidor que controla la devolución de llamada de cliente. El control debe implementar la interfaz ICallbackEventHandler y proporcionar un método RaiseCallbackEvent(String).

argument
String

Argumento pasado desde el script de cliente al método RaiseCallbackEvent(String) de servidor

clientCallback
String

Nombre del controlador de eventos de cliente que recibe el resultado de un evento de servidor correcto.

context
String

El script de cliente que se evalúa en el cliente antes de iniciar la devolución de llamada. El resultado del script se devuelve al controlador de eventos de cliente.

clientErrorCallback
String

Nombre del controlador de eventos de cliente que recibe el resultado cuando se produce un error en el controlador de eventos de servidor.

useAsync
Boolean

Es true para realizar la devolución de llamada de forma asincrónica; es false para realizar la devolución de llamada de forma sincrónica.

Devoluciones

String

El nombre de una función de cliente que invoca la devolución de llamada de cliente.

Excepciones

ArgumentNullException

El Control especificado es null.

InvalidOperationException

El objeto Control no implementa la interfaz ICallbackEventHandler.

Comentarios

Esta sobrecarga del GetCallbackEventReference método requiere un useAsync parámetro y clientErrorCallback . El useAsync parámetro permite realizar la devolución de llamada de cliente de forma asincrónica estableciendo el valor trueen . Las versiones de sobrecarga de este método que no requieren el useAsync parámetro establecen el valor false en de forma predeterminada. El clientErrorCallback parámetro permite definir el nombre de la función cliente a la que se llama si el controlador de servidor (el RaiseCallbackEvent método) devuelve un error. Las versiones de sobrecarga de este método que no requieren el clientErrorCallback parámetro establecen el valor en null.

Para obtener más información sobre este método, vea los comentarios del método de sobrecarga GetCallbackEventReference .

Consulte también

Se aplica a