ClientScriptManager.GetCallbackEventReference Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá odkaz na klientskou funkci, která při vyvolání zahájí volání klienta zpět na událost serveru.

Přetížení

GetCallbackEventReference(Control, String, String, String)	Získá odkaz na klientskou funkci, která při vyvolání zahájí volání klienta zpět na událost serveru. Funkce klienta pro tuto přetíženou metodu obsahuje zadaný ovládací prvek, argument, klientský skript a kontext.
GetCallbackEventReference(Control, String, String, String, Boolean)	Získá odkaz na klientskou funkci, která při vyvolání inicializuje volání klienta zpět na události serveru. Funkce klienta pro tuto přetíženou metodu obsahuje zadaný ovládací prvek, argument, klientský skript, kontext a logickou hodnotu.
GetCallbackEventReference(String, String, String, String, String, Boolean)	Získá odkaz na klientskou funkci, která při vyvolání inicializuje volání klienta zpět na události serveru. Funkce klienta pro tuto přetíženou metodu obsahuje zadaný cíl, argument, klientský skript, kontext, obslužnou rutinu chyb a logickou hodnotu.
GetCallbackEventReference(Control, String, String, String, String, Boolean)	Získá odkaz na klientskou funkci, která při vyvolání zahájí volání klienta zpět na události serveru. Funkce klienta pro tuto přetíženou metodu obsahuje zadaný ovládací prvek, argument, klientský skript, kontext, obslužnou rutinu chyby a logickou hodnotu.

GetCallbackEventReference(Control, String, String, String)

Získá odkaz na klientskou funkci, která při vyvolání zahájí volání klienta zpět na událost serveru. Funkce klienta pro tuto přetíženou metodu obsahuje zadaný ovládací prvek, argument, klientský skript a kontext.

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

Parametry

control: Control

Server Control , který zpracovává zpětné volání klienta. Ovládací prvek musí implementovat ICallbackEventHandler rozhraní a poskytnout metodu RaiseCallbackEvent(String) .

argument: String

Argument předaný z klientského skriptu na server RaiseCallbackEvent(String) Metoda.

clientCallback: String

Název obslužné rutiny události klienta, která obdrží výsledek úspěšné události serveru.

context: String

Klientský skript, který se vyhodnocuje na klientovi před zahájením zpětného volání. Výsledek skriptu se předá zpět do obslužné rutiny události klienta.

Návraty

String

Název klientské funkce, která vyvolá zpětné volání klienta.

Výjimky

ArgumentNullException

Zadané Control je null.

InvalidOperationException

Zadané Control rozhraní neimplementuje ICallbackEventHandler .

Příklady

Následující příklad kódu ukazuje, jak použít dvě přetížení metody ve scénáři zpětného GetCallbackEventReference volání klienta, který zvýší celá čísla.

Zobrazí se dva mechanismy zpětného volání; rozdíl mezi nimi je použití parametru context . Pomocí ReceiveServerData1 parametru se poskytuje funkce zpětného context volání klienta. Naproti tomu funkce zpětného ReceiveServerData2 volání klienta je definována <script> v bloku na stránce. RaiseCallbackEvent Metoda je obslužná rutina serveru, která zvýší hodnotu, která se jí předá, a GetCallbackResult metoda vrátí přírůstkovou hodnotu jako řetězec. RaiseCallbackEvent Pokud metoda vrátí chybu, ProcessCallBackError volá se klientská funkce.

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

Poznámky

Metoda GetCallbackEventReference(Control, String, String, String) provádí zpětné volání mimo pásmo serveru, který je upravenou verzí normálního životního cyklu stránky. Další informace naleznete v tématu Implementace zpětných volání klienta bez postbacků.

Poznámka

Pokud je prohlížeč Microsoft Internet Explorer (verze 5.0 nebo novější), implementuje se mechanismus zpětného volání skriptu prostřednictvím objektu COM Microsoft.XmlHttp a vyžaduje, aby prohlížeč byl nastaven ke spuštění technologie ActiveX ovládacích prvků. V jiných prohlížečích se používá xmlHttpRequest pomocí místního modelu DOM (Document Object Model) prohlížeče. Pokud chcete zkontrolovat, jestli prohlížeč podporuje zpětné volání klienta, použijte SupportsCallback tuto vlastnost. Pokud chcete zkontrolovat, jestli prohlížeč podporuje XML přes HTTP, použijte tuto SupportsXmlHttp vlastnost. Obě vlastnosti jsou přístupné prostřednictvím Browser vlastnosti vnitřní ASP.NET Request objektu.

Přetížení GetCallbackEventReference GetCallbackEventReference metody provádí synchronně zpětné volání pomocí XML přes HTTP. Při synchronním odesílání dat ve scénáři zpětného volání se synchronní zpětné volání vrátí okamžitě a neblokují prohlížeč. V prohlížeči se nedají spustit dva synchronní zpětné volání. Pokud se aktivuje druhý synchronní zpětné volání, zatímco jeden právě čeká na vyřízení, druhý synchronní zpětné volání zruší první a vrátí se pouze druhý zpětné volání.

Pokud chcete odesílat data asynchronně, použijte jedno z přetížení, které přebírá useAsync parametr, což je logická hodnota, která řídí toto chování. V asynchronním scénáři můžete mít více čekajících zpětného volání; pořadí, ve kterém vrátí, však není zaručeno, že odpovídá pořadí, ve kterém byly zahájeny.

Kromě toho toto přetížení GetCallbackEventReference metody určuje žádnou klientskou funkci pro zpracování případu chybového stavu vygenerovaného metodou RaiseCallbackEvent . Chcete-li zadat obslužnou rutinu zpětného volání chyby klienta, použijte jednu z přetížení, která přebírá clientErrorCallback parametr.

Metoda GetCallbackEventReference(Control, String, String, String) přebírá volitelný parametr řetězce argument a vrátí řetězec. Pokud chcete předat nebo přijmout více hodnot, zřetězení hodnot ve vstupním nebo návratovém řetězci, v uvedeném pořadí.

Poznámka

Nepoužívejte stav zobrazení při implementaci vlastností stránky nebo ovládacího prvku, které je potřeba aktualizovat během operací zpětného volání skriptu. Pokud vlastnosti přetrvají požadavky na stránku, můžete použít stav relace.

Viz také

Platí pro

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

Získá odkaz na klientskou funkci, která při vyvolání inicializuje volání klienta zpět na události serveru. Funkce klienta pro tuto přetíženou metodu obsahuje zadaný ovládací prvek, argument, klientský skript, kontext a logickou hodnotu.

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

Parametry

control: Control

Server Control , který zpracovává zpětné volání klienta. Ovládací prvek musí implementovat ICallbackEventHandler rozhraní a poskytnout metodu RaiseCallbackEvent(String) .

argument: String

Argument předaný z klientského skriptu na server RaiseCallbackEvent(String) Metoda.

clientCallback: String

Název obslužné rutiny události klienta, která obdrží výsledek úspěšné události serveru.

context: String

Klientský skript, který se vyhodnocuje na klientovi před zahájením zpětného volání. Výsledek skriptu se předá zpět do obslužné rutiny události klienta.

useAsync: Boolean

true provést zpětné volání asynchronně; false k synchronnímu provedení zpětného volání.

Návraty

String

Název klientské funkce, která vyvolá zpětné volání klienta.

Výjimky

ArgumentNullException

Zadané Control je null.

InvalidOperationException

Zadané Control rozhraní neimplementuje ICallbackEventHandler .

Poznámky

Toto přetížení GetCallbackEventReference metody vyžaduje useAsync parametr, který umožňuje provést zpětné volání klienta asynchronně nastavením hodnoty na true. Verze přetížení této metody, které nevyžadují useAsync parametr nastavit hodnotu ve false výchozím nastavení.

Další informace o této metodě najdete v poznámkách k metodě přetížení GetCallbackEventReference .

Viz také

Platí pro

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

Získá odkaz na klientskou funkci, která při vyvolání inicializuje volání klienta zpět na události serveru. Funkce klienta pro tuto přetíženou metodu obsahuje zadaný cíl, argument, klientský skript, kontext, obslužnou rutinu chyb a logickou hodnotu.

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

Parametry

target: String

Název serveru Control , který zpracovává zpětné volání klienta. Ovládací prvek musí implementovat ICallbackEventHandler rozhraní a poskytnout metodu RaiseCallbackEvent(String) .

argument: String

Argument předaný z klientského skriptu na server RaiseCallbackEvent(String) Metoda.

clientCallback: String

Název obslužné rutiny události klienta, která obdrží výsledek úspěšné události serveru.

context: String

Klientský skript, který se vyhodnocuje na klientovi před zahájením zpětného volání. Výsledek skriptu se předá zpět do obslužné rutiny události klienta.

clientErrorCallback: String

Název obslužné rutiny události klienta, která obdrží výsledek, když dojde k chybě v obslužné rutině události serveru.

useAsync: Boolean

true provést zpětné volání asynchronně; false k synchronnímu provedení zpětného volání.

Návraty

String

Název klientské funkce, která vyvolá zpětné volání klienta.

Příklady

Následující příklad kódu ukazuje, jak použít dvě přetížení metody ve scénáři zpětného GetCallbackEventReference volání klienta, který zvýší celá čísla.

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

Poznámky

Toto přetížení GetCallbackEventReference metody přebírá target parametr řetězce místo parametru Control . Toto přetížení použijte, pokud chcete, aby se zpětné volání vrátilo k něčemu jinému než řetězci obsahujícímu UniqueID ovládací prvek.

Kromě toho toto přetížení GetCallbackEventReference metody vyžaduje useAsync a clientErrorCallback parametr. Parametr useAsync umožňuje provést zpětné volání klienta asynchronně nastavením hodnoty na true. Verze přetížení této metody, které nevyžadují useAsync parametr nastavit hodnotu ve false výchozím nastavení. Parametr clientErrorCallback umožňuje definovat název klientské funkce, která se volá, pokud obslužná rutina serveru, RaiseCallbackEvent metoda vrátí chybu. Verze přetížení této metody, které nevyžadují clientErrorCallback parametr nastavit hodnotu null.

Další informace o této metodě najdete v poznámkách k metodě přetížení GetCallbackEventReference .

Viz také

Platí pro

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

Získá odkaz na klientskou funkci, která při vyvolání zahájí volání klienta zpět na události serveru. Funkce klienta pro tuto přetíženou metodu obsahuje zadaný ovládací prvek, argument, klientský skript, kontext, obslužnou rutinu chyby a logickou hodnotu.

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

Parametry

control: Control

Server Control , který zpracovává zpětné volání klienta. Ovládací prvek musí implementovat ICallbackEventHandler rozhraní a poskytnout metodu RaiseCallbackEvent(String) .

argument: String

Argument předaný z klientského skriptu do metody serveru RaiseCallbackEvent(String) .

clientCallback: String

Název obslužné rutiny události klienta, která obdrží výsledek úspěšné události serveru.

context: String

Klientský skript, který se vyhodnotí na klientovi před zahájením zpětného volání. Výsledek skriptu se předá zpět obslužné rutině události klienta.

clientErrorCallback: String

Název obslužné rutiny události klienta, která obdrží výsledek, když dojde k chybě v obslužné rutině události serveru.

useAsync: Boolean

true provést zpětné volání asynchronně; false k synchronnímu provedení zpětného volání.

Návraty

String

Název klientské funkce, která vyvolá zpětné volání klienta.

Výjimky

ArgumentNullException

Zadaná Control hodnota je null.

InvalidOperationException

Zadané Control rozhraní neimplementuje ICallbackEventHandler .

Poznámky

Toto přetížení GetCallbackEventReference metody vyžaduje useAsync a clientErrorCallback parametr. Parametr useAsync umožňuje provádět zpětné volání klienta asynchronně nastavením hodnoty na true. Verze přetížení této metody, které nevyžadují useAsync parametr nastavit hodnotu false ve výchozím nastavení. Parametr clientErrorCallback umožňuje definovat název klientské funkce, která se volá, pokud obslužná rutina serveru ( RaiseCallbackEvent metoda) vrátí chybu. Verze přetížení této metody, které nevyžadují clientErrorCallback parametr nastavit hodnotu null.

Další informace o této metodě najdete v poznámkách k metodě přetížení GetCallbackEventReference .

Viz také

Platí pro

ClientScriptManager.GetCallbackEventReference Metoda

Definice

Přetížení

GetCallbackEventReference(Control, String, String, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Výjimky

Poznámky

Viz také

Platí pro

Další materiály