ClientScriptManager.GetCallbackEventReference Metod

Definition

Namnområde:: System.Web.UI

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Hämtar en referens till en klientfunktion som när den anropas initierar ett klientanrop tillbaka till en serverhändelse.

Överlagringar

Name	Description
GetCallbackEventReference(Control, String, String, String)	Hämtar en referens till en klientfunktion som när den anropas initierar ett klientanrop tillbaka till en serverhändelse. Klientfunktionen för den här överlagrade metoden innehåller en angiven kontroll, ett argument, ett klientskript och en kontext.
GetCallbackEventReference(Control, String, String, String, Boolean)	Hämtar en referens till en klientfunktion som när den anropas initierar ett klientanrop tillbaka till serverhändelser. Klientfunktionen för den här överlagrade metoden innehåller en angiven kontroll, argument, klientskript, kontext och booleskt värde.
GetCallbackEventReference(String, String, String, String, String, Boolean)	Hämtar en referens till en klientfunktion som när den anropas initierar ett klientanrop tillbaka till serverhändelser. Klientfunktionen för den här överlagrade metoden innehåller ett angivet mål, argument, klientskript, kontext, felhanterare och booleskt värde.
GetCallbackEventReference(Control, String, String, String, String, Boolean)	Hämtar en referens till en klientfunktion som när den anropas initierar ett klientanrop tillbaka till serverhändelser. Klientfunktionen för den här överlagrade metoden innehåller en angiven kontroll, argument, klientskript, kontext, felhanterare och booleskt värde.

GetCallbackEventReference(Control, String, String, String)

Hämtar en referens till en klientfunktion som när den anropas initierar ett klientanrop tillbaka till en serverhändelse. Klientfunktionen för den här överlagrade metoden innehåller en angiven kontroll, ett argument, ett klientskript och en 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

Parametrar

control: Control

Servern Control som hanterar återanropet till klienten. Kontrollen måste implementera ICallbackEventHandler gränssnittet och ange en RaiseCallbackEvent(String) metod.

argument: String

Ett argument som skickas från klientskriptet till servern

RaiseCallbackEvent(String) metod.

clientCallback: String

Namnet på den klienthändelsehanterare som tar emot resultatet av den lyckade serverhändelsen.

context: String

Klientskriptet som utvärderas på klienten innan återanropet initieras. Resultatet av skriptet skickas tillbaka till klienthändelsehanteraren.

Returer

String

Namnet på en klientfunktion som anropar klientåteranropet.

Undantag

ArgumentNullException

Den Control angivna är null.

InvalidOperationException

Den Control angivna implementerar ICallbackEventHandler inte gränssnittet.

Exempel

I följande kodexempel visas hur du använder två överlagringar av GetCallbackEventReference metoden i ett klientåteranropsscenario som ökar heltal.

Två återanropsmekanismer visas. skillnaden mellan dem är användningen av parametern context . En ReceiveServerData1 klientåteranropsfunktion tillhandahålls med hjälp av parametern context . Klientåteranropsfunktionen ReceiveServerData2 definieras däremot i ett <script> block på sidan. En RaiseCallbackEvent metod är serverhanteraren som ökar värdet som skickas till den och GetCallbackResult metoden returnerar det inkrementerade värdet som en sträng. RaiseCallbackEvent Om metoden returnerar ett fel ProcessCallBackError anropas klientfunktionen.

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

Kommentarer

Metoden GetCallbackEventReference(Control, String, String, String) utför ett out-of-band-återanrop till servern som är en modifierad version av en sidas normala livscykel. Mer information finns i Implementera klientåteranrop utan återkopplingar.

Note

När webbläsaren är Microsoft Internet Explorer (version 5.0 eller senare) implementeras mekanismen för återanrop av skript via Microsoft. XmlHttp COM-objekt och kräver att webbläsaren är inställd på att köra ActiveX-kontroller. För andra webbläsare används en XMLHttpRequest med webbläsarens lokala dokumentobjektmodell (DOM). Om du vill kontrollera om en webbläsare stöder klientåteranrop använder du SupportsCallback egenskapen . Om du vill kontrollera om en webbläsare stöder XML via HTTP använder du egenskapen SupportsXmlHttp . Båda egenskaperna är tillgängliga via egenskapen Browser för det inbyggda objektet ASP.NET Request.

Överlagringen GetCallbackEventReference GetCallbackEventReference av metoden utför en återanrop synkront med HJÄLP av XML via HTTP. När du skickar data synkront i ett motringningsscenario returnerar synkrona återanrop omedelbart och blockerar inte webbläsaren. Inga två synkrona återanrop kan köras samtidigt i webbläsaren. Om ett andra synkront återanrop utlöses medan ett för närvarande väntar, avbryts det andra synkrona återanropet det första och endast det andra återanropet returneras.

Om du vill skicka data asynkront använder du en av de överlagringar som tar parametern useAsync , vilket är ett booleskt värde som styr det här beteendet. I det asynkrona scenariot kan du ha flera väntande återanrop. I vilken ordning de returneras garanteras dock inte att de överensstämmer med den ordning som de initierades.

Dessutom anger den här överlagringen GetCallbackEventReference av metoden ingen klientfunktion för att hantera fallet med ett feltillstånd som genereras av RaiseCallbackEvent metoden. Om du vill ange en återanropshanterare för klientfel använder du en av de överlagringar som tar parametern clientErrorCallback .

Metoden GetCallbackEventReference(Control, String, String, String) tar en valfri strängparameter argument och returnerar en sträng. Om du vill skicka in eller ta emot flera värden sammanfogar du värden i indata- eller retursträngen.

Note

Undvik att använda visningstillståndet i implementeringen av sid- eller kontrollegenskaper som behöver uppdateras under återanropsåtgärder för skript. Om egenskaperna ska överleva sidbegäranden kan du använda sessionstillstånd.

Se även

Gäller för

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

Hämtar en referens till en klientfunktion som när den anropas initierar ett klientanrop tillbaka till serverhändelser. Klientfunktionen för den här överlagrade metoden innehåller en angiven kontroll, argument, klientskript, kontext och booleskt värde.

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

Parametrar

control: Control

Servern Control som hanterar återanropet till klienten. Kontrollen måste implementera ICallbackEventHandler gränssnittet och ange en RaiseCallbackEvent(String) metod.

argument: String

Ett argument som skickas från klientskriptet till servern

RaiseCallbackEvent(String) metod.

clientCallback: String

Namnet på den klienthändelsehanterare som tar emot resultatet av den lyckade serverhändelsen.

context: String

Klientskriptet som utvärderas på klienten innan återanropet initieras. Resultatet av skriptet skickas tillbaka till klienthändelsehanteraren.

useAsync: Boolean

true för att utföra återanropet asynkront; false för att utföra återanropet synkront.

Returer

String

Namnet på en klientfunktion som anropar klientåteranropet.

Undantag

ArgumentNullException

Den Control angivna är null.

InvalidOperationException

Den Control angivna implementerar ICallbackEventHandler inte gränssnittet.

Kommentarer

Den här överlagringen GetCallbackEventReference av metoden kräver en useAsync parameter som gör att du kan utföra klientåteranropet asynkront genom att ange värdet till true. Överlagringsversionerna av den här metoden som inte kräver parametern useAsync anger värdet till false som standard.

Mer information om den här metoden finns i kommentarerna för överlagringsmetoden GetCallbackEventReference .

Se även

Gäller för

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

Hämtar en referens till en klientfunktion som när den anropas initierar ett klientanrop tillbaka till serverhändelser. Klientfunktionen för den här överlagrade metoden innehåller ett angivet mål, argument, klientskript, kontext, felhanterare och booleskt värde.

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

Parametrar

target: String

Namnet på en server Control som hanterar återanropet till klienten. Kontrollen måste implementera ICallbackEventHandler gränssnittet och ange en RaiseCallbackEvent(String) metod.

argument: String

Ett argument som skickas från klientskriptet till servern

RaiseCallbackEvent(String) metod.

clientCallback: String

Namnet på den klienthändelsehanterare som tar emot resultatet av den lyckade serverhändelsen.

context: String

Klientskriptet som utvärderas på klienten innan återanropet initieras. Resultatet av skriptet skickas tillbaka till klienthändelsehanteraren.

clientErrorCallback: String

Namnet på den klienthändelsehanterare som tar emot resultatet när ett fel inträffar i serverhändelsehanteraren.

useAsync: Boolean

true för att utföra återanropet asynkront; false för att utföra återanropet synkront.

Returer

String

Namnet på en klientfunktion som anropar klientåteranropet.

Exempel

I följande kodexempel visas hur du använder två överlagringar av GetCallbackEventReference metoden i ett klientåteranropsscenario som ökar heltal.

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

Kommentarer

Den här överlagringen GetCallbackEventReference av metoden tar en target strängparameter i stället för en Control parameter. Använd den här överbelastningen när du vill att återanropet ska gå tillbaka till något annat än en sträng som innehåller UniqueID kontrollens.

Dessutom kräver den här överbelastningen av GetCallbackEventReference metoden en useAsync och en clientErrorCallback parameter. Med useAsync parametern kan du utföra klientåteranropet asynkront genom att ange värdet till true. Överlagringsversionerna av den här metoden som inte kräver parametern useAsync anger värdet till false som standard. Med clientErrorCallback parametern kan du definiera namnet på den klientfunktion som anropas om serverhanteraren, RaiseCallbackEvent metoden, returnerar ett fel. Överlagringsversionerna av den här metoden som inte kräver parametern clientErrorCallback anger värdet till null.

Mer information om den här metoden finns i kommentarerna för överlagringsmetoden GetCallbackEventReference .

Se även

Gäller för

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

Parametrar

control: Control

Servern Control som hanterar återanropet till klienten. Kontrollen måste implementera ICallbackEventHandler gränssnittet och ange en RaiseCallbackEvent(String) metod.

argument: String

Ett argument som skickas från klientskriptet till servermetoden RaiseCallbackEvent(String) .

clientCallback: String

Namnet på den klienthändelsehanterare som tar emot resultatet av den lyckade serverhändelsen.

context: String

Klientskriptet som utvärderas på klienten innan återanropet initieras. Resultatet av skriptet skickas tillbaka till klienthändelsehanteraren.

clientErrorCallback: String

Namnet på den klienthändelsehanterare som tar emot resultatet när ett fel inträffar i serverhändelsehanteraren.

useAsync: Boolean

true för att utföra återanropet asynkront; false för att utföra återanropet synkront.

Returer

String

Namnet på en klientfunktion som anropar klientåteranropet.

Undantag

ArgumentNullException

Den Control angivna är null.

InvalidOperationException

Den Control angivna implementerar ICallbackEventHandler inte gränssnittet.

Kommentarer

Den här överlagringen av GetCallbackEventReference metoden kräver en useAsync och en clientErrorCallback parameter. Med useAsync parametern kan du utföra klientåteranropet asynkront genom att ange värdet till true. Överlagringsversionerna av den här metoden som inte kräver parametern useAsync anger värdet till false som standard. Med clientErrorCallback parametern kan du definiera namnet på den klientfunktion som anropas om serverhanteraren ( RaiseCallbackEvent metoden) returnerar ett fel. Överlagringsversionerna av den här metoden som inte kräver parametern clientErrorCallback anger värdet till null.

Mer information om den här metoden finns i kommentarerna för överlagringsmetoden GetCallbackEventReference .

Se även

Gäller för

Feedback

Var den här sidan till hjälp?