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

GetCallbackEventReference(Control, String, String, String)

Získá odkaz na funkci klienta, která při vyvolání zahájí volání klienta zpět na událost serveru. Funkce klienta pro tuto přetíženou metodu zahrnuje 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á přijímá 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 funkce klienta, která vyvolá zpětné volání klienta.

Výjimky

ArgumentNullException

Zadaná Control hodnota je null.

InvalidOperationException

Zadaný Control neimplementuje ICallbackEventHandler rozhraní.

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.

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

<%@ 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í serveru, který je upravenou verzí normálního životního cyklu stránky. Další informace najdete v tématu Implementace klientských zpětných volání bez zpětných volání.

Poznámka

Pokud je prohlížečem Microsoft Internet Explorer (verze 5.0 nebo novější), mechanismus zpětného volání skriptu se implementuje prostřednictvím objektu COM Microsoft.XmlHttp a vyžaduje, aby byl prohlížeč nastavený na spouštění ovládacích prvků ActiveX. 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 vlastnost . Pokud chcete zkontrolovat, jestli prohlížeč podporuje XML přes HTTP, použijte SupportsXmlHttp vlastnost . Obě vlastnosti jsou přístupné prostřednictvím Browser vlastnosti vnitřního objektu ASP.NET Request .

Přetížení GetCallbackEventReference GetCallbackEventReference metody provádí zpětné volání synchronně 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í vrací okamžitě a neblokují prohlížeč. Žádná dvě synchronní zpětná volání nelze spustit současně v prohlížeči. Pokud se aktivuje druhé synchronní zpětné volání, zatímco jedno je aktuálně čekající, druhé synchronní zpětné volání zruší první a vrátí se pouze druhé zpětné volání.

Chcete-li 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ých volání. pořadí, ve kterém se 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, že žádná klientská funkce nebude zpracovávat případ chybového stavu vygenerovaného metodou RaiseCallbackEvent . Pokud chcete určit obslužnou rutinu zpětného volání chyby klienta, použijte jedno 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ězte hodnoty ve vstupním nebo návratovém řetězci.

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 mají 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 funkci klienta, která při vyvolání zahájí volání klienta zpět na události serveru. Funkce klienta pro tuto přetíženou metodu zahrnuje 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á přijímá 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 a proveďte zpětné volání synchronně.

Návraty

String

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

Výjimky

ArgumentNullException

Zadaná Control hodnota je null.

InvalidOperationException

Zadaný Control neimplementuje ICallbackEventHandler rozhraní.

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. Přetížené verze této metody, které nevyžadují useAsync parametr nastavit hodnotu ve výchozím nastavení na false .

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 funkci klienta, která při vyvolání zahájí volání klienta zpět na události serveru. Funkce klienta pro tuto přetíženou metodu zahrnuje zadaný cíl, argument, klientský skript, kontext, obslužnou rutinu chyby 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á přijímá 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 a proveďte zpětné volání synchronně.

Návraty

String

Název funkce klienta, 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á řetězcový target parametr 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ž k řetězci UniqueID obsahujícímu ovládací prvek.

Kromě toho toto přetížení GetCallbackEventReference metody vyžaduje useAsync parametr a clientErrorCallback . Parametr useAsync umožňuje provést zpětné volání klienta asynchronně nastavením hodnoty na true. Přetížené verze této metody, které nevyžadují useAsync parametr nastavit hodnotu ve výchozím nastavení na false . Parametr clientErrorCallback umožňuje definovat název funkce klienta, která je volána, pokud obslužná rutina serveru, RaiseCallbackEvent metoda, vrátí chybu. Přetížení verze 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)

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 metodě 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 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álostí 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 pro provedení zpětného volání synchronně.

Návraty

String

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

Výjimky

ArgumentNullException

Zadaná Control hodnota je null.

InvalidOperationException

Zadaný Control parametr neimplementuje ICallbackEventHandler rozhraní .

Poznámky

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

Sdílet prostřednictvím

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