Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

ClientScriptManager.GetCallbackEventReference Método (String, String, String, String, String, Boolean)

Obtém uma referência a uma função cliente que, quando chamado, inicia um chamar cliente Voltar para eventos servidor. A função do cliente para este método sobrecarregado inclui um destino especificado, argumento, script do cliente, contexto, identificador de erro e valor booleano.

Namespace:  System.Web.UI
Assembly:  System.Web (em System.Web. dll)

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

Parâmetros

target
Tipo: System.String

The name of a server Control that handles the client callback.The control must implement the ICallbackEventHandler interface and provide a RaiseCallbackEvent method.

argument
Tipo: System.String

Um argumento passado a partir do script de cliente para o servidor

RaiseCallbackEvent method.

clientCallback
Tipo: System.String

O nome do manipulador de eventos do cliente que recebe o resultado do evento de servidor com êxito.

context
Tipo: System.String

Script de cliente que é avaliado no cliente antes para iniciar o retorno de chamada.The result of the script is Passed voltar to the cliente evento manipulador.

clientErrorCallback
Tipo: System.String

O nome do manipulador de eventos do cliente que recebe o resultado quando ocorre um erro no manipulador de eventos do servidor.

useAsync
Tipo: System.Boolean

true to perform the callback asynchronously; false to perform the callback synchronously.

Valor de retorno

Tipo: System.String

O nome de uma função do cliente que invoca o retorno de chamada do cliente.

This overload of the GetCallbackEventReference method takes a target string parameter instead of a Control parameter.Use this overload when you want the callback to go back to something other than a string containing the UniqueID of the control.

Additionally, this overload of the GetCallbackEventReference method requires a useAsync and a clientErrorCallback parameter.The useAsync parameter allows you to perform the client callback asynchronously by setting the value to true.The overload versions of this method that do not require the useAsync parameter set the value to false by default.The clientErrorCallback parameter allows you to define the name of the client function that is called if the server handler, the RaiseCallbackEvent method, returns an error.The overload versions of this method that do not require the clientErrorCallback parameter set the value to null.

For more information on this method, see the remarks for the overload GetCallbackEventReference method.

The following code example demonstrates how to use two overloads of the GetCallbackEventReference method in a client callback scenario that increments integers.

Two callback mechanisms are shown; the difference between them is the use of the context parameter.A ReceiveServerData1 client callback function is provided using the context parameter.In contrast, the ReceiveServerData2 client callback function is defined in a <script> block on the page.A RaiseCallbackEvent method is the server handler that increments the value that is passed to it and the GetCallbackResult method returns the incremented value as a string.If the RaiseCallbackEvent method returns an error, then the client function ProcessCallBackError is called.

<%@ Page Language= %>
<%@ Implements Interface= %>

<!DOCTYPE html PUBLIC "-

<script runat=>

      cbCount = 0;

    
      RaiseCallbackEvent(String eventArgument)
    {
        cbCount = Convert.ToInt32(eventArgument) + 1;
    }

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

      Page_Load(object sender, EventArgs e)
    {
        
        StringBuilder sb =  StringBuilder();

        
        sb.Append();
         (Page.IsPostBack)
        {
            sb.Append();
        }

        
        MyLabel.Text = sb.ToString();

        
        ClientScriptManager cs = Page.ClientScript;

        
        
        StringBuilder context1 =  StringBuilder();
        context1.Append();
        context1.Append();
        context1.Append();
        context1.Append();
        context1.Append();

        
        String cbReference1 = cs.GetCallbackEventReference(, , 
            , context1.ToString());
        String cbReference2 = cs.GetCallbackEventReference( + 
            Page.UniqueID + , , , , 
            , );
        String callbackScript1 =  + 
            cbReference1 + ;
        String callbackScript2 =  + 
            cbReference2 + ;

        
        cs.RegisterClientScriptBlock(.GetType(), , 
            callbackScript1, );
        cs.RegisterClientScriptBlock(.GetType(), , 
            callbackScript2, );

    }
</script>

<script type=>
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:
<head id= runat=>
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id= 
          runat=>
    <div>
      Callback 1 result: <span id=>0</span>
      <br />
      Callback 2 result: <span id=>0</span>
      <br /> <br />
      <input type= 
             value= 
             onclick=/>    
      <input type= 
             value= 
             onclick=/>
      <br /> <br />
      <asp:Label id= 
                 runat=></asp:Label>
    </div>
    </form>
</body>
</html>


Contribuições da comunidade

ADICIONAR
Mostrar: