ClientScriptManager.GetCallbackEventReference Méthode

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient la référence à une fonction cliente qui, lorsqu'elle est appelée, entraîne un rappel d'un événement serveur par le client.

Surcharges

GetCallbackEventReference(Control, String, String, String)	Obtient la référence à une fonction cliente qui, lorsqu'elle est appelée, entraîne un rappel d'un événement serveur par le client. La fonction cliente de cette méthode surchargée inclut un contrôle, un argument, un script client et un contexte spécifiés.
GetCallbackEventReference(Control, String, String, String, Boolean)	Obtient la référence à une fonction cliente qui, lorsqu'elle est appelée, entraîne un rappel d'événements serveur par le client. La fonction cliente de cette méthode surchargée inclut un contrôle, un argument, un script client, un contexte et une valeur booléenne spécifiés.
GetCallbackEventReference(String, String, String, String, String, Boolean)	Obtient la référence à une fonction cliente qui, lorsqu'elle est appelée, entraîne un rappel d'événements serveur par le client. La fonction cliente de cette méthode surchargée inclut une cible, un argument, un script client, un contexte, un gestionnaire d'erreurs et une valeur booléenne spécifiés.
GetCallbackEventReference(Control, String, String, String, String, Boolean)	Obtient la référence à une fonction cliente qui, lorsqu'elle est appelée, entraîne un rappel d'événements serveur par le client. La fonction cliente de cette méthode surchargée inclut un contrôle, un argument, un script client, un contexte, un gestionnaire d'erreurs et une valeur booléenne spécifiés.

GetCallbackEventReference(Control, String, String, String)

Obtient la référence à une fonction cliente qui, lorsqu'elle est appelée, entraîne un rappel d'un événement serveur par le client. La fonction cliente de cette méthode surchargée inclut un contrôle, un argument, un script client et un contexte spécifiés.

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

Paramètres

control: Control

Serveur Control qui gère le rappel client. Le contrôle doit implémenter l'interface ICallbackEventHandler et fournir une méthode RaiseCallbackEvent(String).

argument: String

Argument passé du script client au serveur

MéthodeRaiseCallbackEvent(String) .

clientCallback: String

Nom du gestionnaire d'événements client qui reçoit le résultat de l'événement serveur réussi.

context: String

Le script client qui est évalué sur le client avant l'initialisation du rappel. Le résultat du script est repassé au gestionnaire d'événements client.

Retours

String

Nom d'une fonction cliente qui appelle le rappel client.

Exceptions

ArgumentNullException

Le Control spécifié a la valeur null.

InvalidOperationException

Le Control spécifié n'implémente pas l'interface ICallbackEventHandler.

Exemples

L’exemple de code suivant montre comment utiliser deux surcharges de la GetCallbackEventReference méthode dans un scénario de rappel de client qui incrémente des entiers.

Deux mécanismes de rappel sont affichés ; la différence entre eux est l’utilisation du context paramètre . Une ReceiveServerData1 fonction de rappel client est fournie à l’aide du context paramètre . En revanche, la ReceiveServerData2 fonction de rappel du client est définie dans un <script> bloc de la page. Une RaiseCallbackEvent méthode est le gestionnaire de serveur qui incrémente la valeur qui lui est passée et la GetCallbackResult méthode retourne la valeur incrémentée sous forme de chaîne. Si la RaiseCallbackEvent méthode retourne une erreur, la ProcessCallBackError fonction cliente est appelée.

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

Remarques

La GetCallbackEventReference(Control, String, String, String) méthode effectue un rappel hors bande au serveur qui est une version modifiée du cycle de vie normal d’une page. Pour plus d’informations, consultez Implémentation de rappels de clients sans publication.

Notes

Lorsque le navigateur est Microsoft Internet Explorer (version 5.0 ou ultérieure), le mécanisme de rappel de script est implémenté via le Microsoft. XmlHttp COM et nécessite que le navigateur soit défini pour exécuter des contrôles ActiveX. Pour les autres navigateurs, une requête XMLHttpRequest utilisant le dom (Document Object Model) local du navigateur est utilisée. Pour vérifier si un navigateur prend en charge les rappels de clients, utilisez la SupportsCallback propriété . Pour vérifier si un navigateur prend en charge XML sur HTTP, utilisez la SupportsXmlHttp propriété . Les deux propriétés sont accessibles via la Browser propriété de l’objet ASP.NET Request intrinsèque.

La GetCallbackEventReference surcharge de la GetCallbackEventReference méthode effectue un rappel de façon synchrone à l’aide de XML sur HTTP. Lors de l’envoi de données de manière synchrone dans un scénario de rappel, les rappels synchrones sont retournés immédiatement et ne bloquent pas le navigateur. Deux rappels synchrones ne peuvent pas s’exécuter en même temps dans le navigateur. Si un deuxième rappel synchrone est déclenché alors qu’un rappel est actuellement en attente, le deuxième rappel synchrone annule le premier et seul le deuxième rappel est retourné.

Pour envoyer des données de manière asynchrone, utilisez l’une des surcharges qui accepte le useAsync paramètre, qui est une valeur booléenne contrôlant ce comportement. Dans le scénario asynchrone, vous pouvez avoir plusieurs rappels en attente ; toutefois, l’ordre dans lequel ils retournent n’est pas garanti de correspondre à l’ordre dans lequel ils ont été lancés.

En outre, cette surcharge de la GetCallbackEventReference méthode ne spécifie aucune fonction cliente pour gérer le cas d’une condition d’erreur générée par la RaiseCallbackEvent méthode . Pour spécifier un gestionnaire de rappel d’erreur client, utilisez l’une des surcharges qui accepte le clientErrorCallback paramètre .

La GetCallbackEventReference(Control, String, String, String) méthode prend un paramètre de chaîne argument facultatif et retourne une chaîne. Pour passer ou recevoir plusieurs valeurs, concaténer des valeurs dans la chaîne d’entrée ou de retour, respectivement.

Notes

Évitez d’utiliser l’état d’affichage dans l’implémentation des propriétés de page ou de contrôle qui doivent être mises à jour pendant les opérations de rappel de script. Si les propriétés doivent survivre aux demandes de page, vous pouvez utiliser l’état de session.

Voir aussi

S’applique à

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

Obtient la référence à une fonction cliente qui, lorsqu'elle est appelée, entraîne un rappel d'événements serveur par le client. La fonction cliente de cette méthode surchargée inclut un contrôle, un argument, un script client, un contexte et une valeur booléenne spécifiés.

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

Paramètres

control: Control

Serveur Control qui gère le rappel client. Le contrôle doit implémenter l'interface ICallbackEventHandler et fournir une méthode RaiseCallbackEvent(String).

argument: String

Argument passé du script client au serveur

MéthodeRaiseCallbackEvent(String) .

clientCallback: String

Nom du gestionnaire d'événements client qui reçoit le résultat de l'événement serveur réussi.

context: String

Le script client qui est évalué sur le client avant l'initialisation du rappel. Le résultat du script est repassé au gestionnaire d'événements client.

useAsync: Boolean

true pour exécuter le rappel de manière asynchrone ; false pour l'exécuter de manière synchrone.

Retours

String

Nom d'une fonction cliente qui appelle le rappel client.

Exceptions

ArgumentNullException

Le Control spécifié a la valeur null.

InvalidOperationException

Le Control spécifié n'implémente pas l'interface ICallbackEventHandler.

Remarques

Cette surcharge de la GetCallbackEventReference méthode nécessite un useAsync paramètre, qui vous permet d’effectuer le rappel du client de manière asynchrone en définissant la valeur sur true. Les versions de surcharge de cette méthode qui ne nécessitent pas le useAsync paramètre définissent la valeur false sur par défaut.

Pour plus d’informations sur cette méthode, consultez les remarques relatives à la méthode de surcharge GetCallbackEventReference .

Voir aussi

S’applique à

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

Obtient la référence à une fonction cliente qui, lorsqu'elle est appelée, entraîne un rappel d'événements serveur par le client. La fonction cliente de cette méthode surchargée inclut une cible, un argument, un script client, un contexte, un gestionnaire d'erreurs et une valeur booléenne spécifiés.

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

Paramètres

target: String

Nom d'un Control serveur qui gère le rappel client. Le contrôle doit implémenter l'interface ICallbackEventHandler et fournir une méthode RaiseCallbackEvent(String).

argument: String

Argument passé du script client au serveur

MéthodeRaiseCallbackEvent(String) .

clientCallback: String

Nom du gestionnaire d'événements client qui reçoit le résultat de l'événement serveur réussi.

context: String

Le script client qui est évalué sur le client avant l'initialisation du rappel. Le résultat du script est repassé au gestionnaire d'événements client.

clientErrorCallback: String

Nom du gestionnaire d'événements client qui reçoit le résultat lorsqu'une erreur se produit au niveau du gestionnaire d'événements serveur.

useAsync: Boolean

true pour exécuter le rappel de manière asynchrone ; false pour l'exécuter de manière synchrone.

Retours

String

Nom d'une fonction cliente qui appelle le rappel client.

Exemples

L’exemple de code suivant montre comment utiliser deux surcharges de la GetCallbackEventReference méthode dans un scénario de rappel de client qui incrémente des entiers.

Deux mécanismes de rappel sont affichés ; la différence entre eux est l’utilisation du context paramètre . Une ReceiveServerData1 fonction de rappel client est fournie à l’aide du context paramètre . En revanche, la ReceiveServerData2 fonction de rappel du client est définie dans un <script> bloc de la page. Une RaiseCallbackEvent méthode est le gestionnaire de serveur qui incrémente la valeur qui lui est passée et la GetCallbackResult méthode retourne la valeur incrémentée sous forme de chaîne. Si la RaiseCallbackEvent méthode retourne une erreur, la fonction ProcessCallBackError cliente est appelée.

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

Remarques

Cette surcharge de la GetCallbackEventReference méthode accepte un target paramètre de chaîne au lieu d’un Control paramètre . Utilisez cette surcharge lorsque vous souhaitez que le rappel retourne à quelque chose d’autre qu’une chaîne contenant le UniqueID du contrôle.

En outre, cette surcharge de la GetCallbackEventReference méthode nécessite un useAsync et un clientErrorCallback paramètre . Le useAsync paramètre vous permet d’effectuer le rappel du client de manière asynchrone en définissant la valeur sur true. Les versions de surcharge de cette méthode qui ne nécessitent pas le useAsync paramètre définissent la valeur false sur par défaut. Le clientErrorCallback paramètre vous permet de définir le nom de la fonction cliente appelée si le gestionnaire de serveur, la RaiseCallbackEvent méthode , retourne une erreur. Les versions de surcharge de cette méthode qui ne nécessitent pas le clientErrorCallback paramètre définissent la valeur sur null.

Pour plus d’informations sur cette méthode, consultez les remarques relatives à la méthode de surcharge GetCallbackEventReference .

Voir aussi

S’applique à

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

Paramètres

control: Control

Serveur Control qui gère le rappel client. Le contrôle doit implémenter l'interface ICallbackEventHandler et fournir une méthode RaiseCallbackEvent(String).

argument: String

Argument passé du script client à la méthode RaiseCallbackEvent(String) du serveur.

clientCallback: String

Nom du gestionnaire d'événements client qui reçoit le résultat de l'événement serveur réussi.

context: String

Le script client qui est évalué sur le client avant l'initialisation du rappel. Le résultat du script est repassé au gestionnaire d'événements client.

clientErrorCallback: String

Nom du gestionnaire d'événements client qui reçoit le résultat lorsqu'une erreur se produit au niveau du gestionnaire d'événements serveur.

useAsync: Boolean

true pour exécuter le rappel de manière asynchrone ; false pour l'exécuter de manière synchrone.

Retours

String

Nom d'une fonction cliente qui appelle le rappel client.

Exceptions

ArgumentNullException

Le Control spécifié a la valeur null.

InvalidOperationException

Le Control spécifié n'implémente pas l'interface ICallbackEventHandler.

Remarques

Cette surcharge de la GetCallbackEventReference méthode nécessite un useAsync paramètre et .clientErrorCallback Le useAsync paramètre vous permet d’effectuer le rappel du client de manière asynchrone en définissant la valeur sur true. Les versions de surcharge de cette méthode qui ne nécessitent pas le useAsync paramètre définissent la valeur false sur par défaut. Le clientErrorCallback paramètre vous permet de définir le nom de la fonction cliente appelée si le gestionnaire de serveur (la RaiseCallbackEvent méthode) retourne une erreur. Les versions de surcharge de cette méthode qui ne nécessitent pas le clientErrorCallback paramètre définissent la valeur null.

Pour plus d’informations sur cette méthode, consultez les remarques relatives à la méthode de surcharge GetCallbackEventReference .

Voir aussi

S’applique à

ClientScriptManager.GetCallbackEventReference Méthode

Définition

Surcharges

GetCallbackEventReference(Control, String, String, String)

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

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

Paramètres

Retours

Exceptions

Remarques

Voir aussi

S’applique à

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

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

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

Paramètres

Retours

Exceptions

Remarques

Voir aussi

S’applique à

Commentaires

Ressources supplémentaires