ClientScriptManager.GetCallbackEventReference Metoda

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í

Name	Description
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 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 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, 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 obslužné rutině události klienta.

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 .

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 . Funkce ReceiveServerData1 zpětného volání klienta je k dispozici pomocí parametru context . Naproti tomu funkce zpětného ReceiveServerData2 volání klienta je definována <script> v bloku na stránce. Metoda je obslužná RaiseCallbackEvent rutina serveru, která zvýší hodnotu, která je jí předána, a GetCallbackResult metoda vrátí přírůstkovou hodnotu jako řetězec. RaiseCallbackEvent Pokud metoda vrátí chybu, pak ProcessCallBackError je volána 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) provede zpětné volání mimo pásmo na server, 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ší), mechanismus zpětného volání skriptu se implementuje prostřednictvím objektu COM Microsoft.XmlHttp a vyžaduje, aby prohlížeč byl nastaven pro spuš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í klientů, použijte SupportsCallback tuto vlastnost. Chcete-li zkontrolovat, zda prohlížeč podporuje XML přes HTTP, použijte 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í okamžitě vrátí a neblokují prohlížeč. V prohlížeči se nedají spustit žádné dva synchronní zpětné volání. Pokud se aktivuje druhý synchronní zpětné volání, zatímco jeden čeká na vyřízení, 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 řízení tohoto 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 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 jedno z přetížení, které přebírá clientErrorCallback parametr.

Metoda GetCallbackEventReference(Control, String, String, String) přebírá volitelný řetězcový argument parametr a vrací ř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řežijí 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 obslužné rutině události klienta.

useAsync: Boolean

true k asynchronnímu provedení zpětného volání; 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 parametr, který 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 ve false výchozím nastavení.

Další informace o této metodě naleznete 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 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á 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 obslužné rutině události klienta.

clientErrorCallback: String

Název obslužné rutiny události klienta, která obdrží výsledek v případě chyby v obslužné rutině události serveru.

useAsync: Boolean

true k asynchronnímu provedení zpětného volání; 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 asynchronní provedení zpětného volání klienta nastavením hodnoty na truehodnotu . Přetížené verze 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. Přetížené verze této metody, které nevyžadují clientErrorCallback parametr nastavit hodnotu null.

Další informace o této metodě naleznete 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 obslužné rutině události klienta.

clientErrorCallback: String

Název obslužné rutiny události klienta, která obdrží výsledek v případě chyby v obslužné rutině události serveru.

useAsync: Boolean

true k asynchronnímu provedení zpětného volání; 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 parametr a clientErrorCallback parametr. Parametr useAsync umožňuje asynchronní provedení zpětného volání klienta nastavením hodnoty na truehodnotu . Přetížené verze 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. Přetížené verze této metody, které nevyžadují clientErrorCallback parametr nastavit hodnotu null.

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

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?

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

Váš názor