ClientScriptManager.GetCallbackEventReference Metode

Referensi

Definisi

Ruang nama:: System.Web.UI

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server.

Overload

GetCallbackEventReference(Control, String, String, String)	Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server. Fungsi klien untuk metode yang kelebihan beban ini mencakup kontrol, argumen, skrip klien, dan konteks tertentu.
GetCallbackEventReference(Control, String, String, String, Boolean)	Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server. Fungsi klien untuk metode kelebihan beban ini mencakup kontrol, argumen, skrip klien, konteks, dan nilai Boolean tertentu.
GetCallbackEventReference(String, String, String, String, String, Boolean)	Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server. Fungsi klien untuk metode kelebihan beban ini mencakup target, argumen, skrip klien, konteks, penangan kesalahan, dan nilai Boolean tertentu.
GetCallbackEventReference(Control, String, String, String, String, Boolean)	Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server. Fungsi klien untuk metode kelebihan beban ini mencakup kontrol, argumen, skrip klien, konteks, penangan kesalahan, dan nilai Boolean yang ditentukan.

GetCallbackEventReference(Control, String, String, String)

Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server. Fungsi klien untuk metode yang kelebihan beban ini mencakup kontrol, argumen, skrip klien, dan konteks tertentu.

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

Parameter

control: Control

Server Control yang menangani panggilan balik klien. Kontrol harus mengimplementasikan ICallbackEventHandler antarmuka dan menyediakan RaiseCallbackEvent(String) metode .

argument: String

Argumen yang diteruskan dari skrip klien ke server

RaiseCallbackEvent(String) metode.

clientCallback: String

Nama penanganan aktivitas klien yang menerima hasil dari peristiwa server yang berhasil.

context: String

Skrip klien yang dievaluasi pada klien sebelum memulai panggilan balik. Hasil skrip diteruskan kembali ke penanganan aktivitas klien.

Mengembalikan

String

Nama fungsi klien yang memanggil panggilan balik klien.

Pengecualian

ArgumentNullException

Yang Control ditentukan adalah null.

InvalidOperationException

Yang Control ditentukan tidak mengimplementasikan ICallbackEventHandler antarmuka.

Contoh

Contoh kode berikut menunjukkan cara menggunakan dua kelebihan beban GetCallbackEventReference metode dalam skenario panggilan balik klien yang menambah bilangan bulat.

Dua mekanisme panggilan balik ditampilkan; perbedaan di antara keduanya adalah penggunaan context parameter . Fungsi ReceiveServerData1 panggilan balik klien disediakan menggunakan context parameter . Sebaliknya, ReceiveServerData2 fungsi panggilan balik klien didefinisikan dalam <script> blok pada halaman. Metode RaiseCallbackEvent adalah handler server yang menambah nilai yang diteruskan ke dalamnya dan GetCallbackResult metode mengembalikan nilai bertahap sebagai string. RaiseCallbackEvent Jika metode mengembalikan kesalahan, maka ProcessCallBackError fungsi klien dipanggil.

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

Keterangan

Metode ini GetCallbackEventReference(Control, String, String, String) melakukan panggilan balik di luar band ke server yang merupakan versi yang dimodifikasi dari siklus hidup normal halaman. Untuk informasi selengkapnya, lihat Menerapkan Panggilan Balik Klien Tanpa Postback.

Catatan

Saat browser adalah Microsoft Internet Explorer (versi 5.0 atau yang lebih baru), mekanisme panggilan balik skrip diimplementasikan melalui objek Microsoft.XmlHttp COM dan mengharuskan browser diatur untuk menjalankan kontrol ActiveX. Untuk browser lain, XMLHttpRequest menggunakan Model Objek Dokumen (DOM) lokal browser digunakan. Untuk memeriksa apakah browser mendukung panggilan balik klien, gunakan SupportsCallback properti . Untuk memeriksa apakah browser mendukung XML melalui HTTP, gunakan SupportsXmlHttp properti . Kedua properti dapat diakses melalui Browser properti objek ASP.NET Request intrinsik.

Kelebihan GetCallbackEventReference beban GetCallbackEventReference metode melakukan panggilan balik secara sinkron menggunakan XML melalui HTTP. Saat mengirim data secara sinkron dalam skenario panggilan balik, panggilan balik sinkron segera kembali dan tidak memblokir browser. Tidak ada dua panggilan balik sinkron yang dapat dijalankan pada saat yang sama di browser. Jika panggilan balik sinkron kedua diaktifkan saat satu saat ini tertunda, panggilan balik sinkron kedua membatalkan panggilan balik pertama dan hanya panggilan balik kedua yang akan kembali.

Untuk mengirim data secara asinkron, gunakan salah satu kelebihan beban yang mengambil useAsync parameter , yang merupakan nilai Boolean yang mengontrol perilaku ini. Dalam skenario asinkron, Anda dapat memiliki beberapa panggilan balik yang tertunda; namun, urutan di mana mereka kembali tidak dijamin cocok dengan urutan di mana mereka dimulai.

Selain itu, kelebihan beban GetCallbackEventReference metode ini menentukan tidak ada fungsi klien untuk menangani kasus kondisi kesalahan yang dihasilkan oleh RaiseCallbackEvent metode . Untuk menentukan handler panggilan balik kesalahan klien, gunakan salah satu kelebihan beban yang mengambil clientErrorCallback parameter .

Metode ini GetCallbackEventReference(Control, String, String, String) mengambil parameter string argument opsional dan mengembalikan string. Untuk meneruskan atau menerima beberapa nilai, gabungkan nilai dalam string input atau pengembalian, masing-masing.

Catatan

Hindari menggunakan status tampilan dalam implementasi properti halaman atau kontrol yang perlu diperbarui selama operasi panggilan balik skrip. Jika properti untuk bertahan dari permintaan halaman, Anda dapat menggunakan status sesi.

Lihat juga

Berlaku untuk

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

Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server. Fungsi klien untuk metode kelebihan beban ini mencakup kontrol, argumen, skrip klien, konteks, dan nilai Boolean tertentu.

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

Parameter

control: Control

Server Control yang menangani panggilan balik klien. Kontrol harus mengimplementasikan ICallbackEventHandler antarmuka dan menyediakan RaiseCallbackEvent(String) metode .

argument: String

Argumen yang diteruskan dari skrip klien ke server

RaiseCallbackEvent(String) metode.

clientCallback: String

Nama penanganan aktivitas klien yang menerima hasil dari peristiwa server yang berhasil.

context: String

Skrip klien yang dievaluasi pada klien sebelum memulai panggilan balik. Hasil skrip diteruskan kembali ke penanganan aktivitas klien.

useAsync: Boolean

true untuk melakukan panggilan balik secara asinkron; false untuk melakukan panggilan balik secara sinkron.

Mengembalikan

String

Nama fungsi klien yang memanggil panggilan balik klien.

Pengecualian

ArgumentNullException

Yang Control ditentukan adalah null.

InvalidOperationException

Yang Control ditentukan tidak mengimplementasikan ICallbackEventHandler antarmuka.

Keterangan

Kelebihan metode GetCallbackEventReference ini memerlukan useAsync parameter, yang memungkinkan Anda melakukan panggilan balik klien secara asinkron dengan mengatur nilai ke true. Versi kelebihan beban dari metode ini yang tidak memerlukan useAsync parameter yang mengatur nilai ke false secara default.

Untuk informasi selengkapnya tentang metode ini, lihat keterangan untuk metode kelebihan beban GetCallbackEventReference .

Lihat juga

Berlaku untuk

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

Mendapatkan referensi ke fungsi klien yang, ketika dipanggil, memulai panggilan klien kembali ke peristiwa server. Fungsi klien untuk metode kelebihan beban ini mencakup target, argumen, skrip klien, konteks, penangan kesalahan, dan nilai Boolean tertentu.

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

Parameter

target: String

Nama server Control yang menangani panggilan balik klien. Kontrol harus mengimplementasikan ICallbackEventHandler antarmuka dan menyediakan RaiseCallbackEvent(String) metode .

argument: String

Argumen yang diteruskan dari skrip klien ke server

RaiseCallbackEvent(String) metode.

clientCallback: String

Nama penanganan aktivitas klien yang menerima hasil dari peristiwa server yang berhasil.

context: String

Skrip klien yang dievaluasi pada klien sebelum memulai panggilan balik. Hasil skrip diteruskan kembali ke penanganan aktivitas klien.

clientErrorCallback: String

Nama penanganan aktivitas klien yang menerima hasil ketika kesalahan terjadi di penanganan aktivitas server.

useAsync: Boolean

true untuk melakukan panggilan balik secara asinkron; false untuk melakukan panggilan balik secara sinkron.

Mengembalikan

String

Nama fungsi klien yang memanggil panggilan balik klien.

Contoh

Contoh kode berikut menunjukkan cara menggunakan dua kelebihan beban GetCallbackEventReference metode dalam skenario panggilan balik klien yang menambah bilangan bulat.

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

Keterangan

Kelebihan beban GetCallbackEventReference metode ini mengambil target parameter string alih-alih Control parameter. Gunakan kelebihan beban ini saat Anda ingin panggilan balik kembali ke sesuatu selain string yang berisi UniqueID kontrol.

Selain itu, kelebihan beban GetCallbackEventReference metode ini memerlukan useAsync parameter dan clientErrorCallback . Parameter useAsync memungkinkan Anda untuk melakukan panggilan balik klien secara asinkron dengan mengatur nilai ke true. Versi kelebihan beban dari metode ini yang tidak memerlukan useAsync parameter yang mengatur nilai ke false secara default. Parameter clientErrorCallback memungkinkan Anda menentukan nama fungsi klien yang dipanggil jika handler server, RaiseCallbackEvent metode , mengembalikan kesalahan. Versi kelebihan beban dari metode ini yang tidak memerlukan clientErrorCallback parameter yang mengatur nilai ke null.

Untuk informasi selengkapnya tentang metode ini, lihat keterangan untuk metode kelebihan beban GetCallbackEventReference .

Lihat juga

Berlaku untuk

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

Parameter

control: Control

Server Control yang menangani panggilan balik klien. Kontrol harus mengimplementasikan ICallbackEventHandler antarmuka dan menyediakan RaiseCallbackEvent(String) metode .

argument: String

Argumen yang diteruskan dari skrip klien ke metode server RaiseCallbackEvent(String) .

clientCallback: String

Nama penanganan aktivitas klien yang menerima hasil dari peristiwa server yang berhasil.

context: String

Skrip klien yang dievaluasi pada klien sebelum memulai panggilan balik. Hasil skrip diteruskan kembali ke penanganan aktivitas klien.

clientErrorCallback: String

Nama penanganan aktivitas klien yang menerima hasil ketika terjadi kesalahan di penanganan aktivitas server.

useAsync: Boolean

true untuk melakukan panggilan balik secara asinkron; false untuk melakukan panggilan balik secara sinkron.

Mengembalikan

String

Nama fungsi klien yang memanggil panggilan balik klien.

Pengecualian

ArgumentNullException

Yang Control ditentukan adalah null.

InvalidOperationException

Yang Control ditentukan tidak mengimplementasikan ICallbackEventHandler antarmuka.

Keterangan

Kelebihan metode GetCallbackEventReference ini memerlukan useAsync parameter dan clientErrorCallback . Parameter useAsync memungkinkan Anda untuk melakukan panggilan balik klien secara asinkron dengan mengatur nilai ke true. Versi kelebihan beban metode ini yang tidak memerlukan useAsync parameter yang mengatur nilai ke false secara default. Parameter clientErrorCallback memungkinkan Anda menentukan nama fungsi klien yang dipanggil jika handler server ( RaiseCallbackEvent metode ) mengembalikan kesalahan. Versi kelebihan beban metode ini yang tidak memerlukan clientErrorCallback parameter yang mengatur nilai menjadi null.

Untuk informasi selengkapnya tentang metode ini, lihat keterangan untuk metode kelebihan beban GetCallbackEventReference .

Lihat juga

Berlaku untuk

Bagikan melalui

ClientScriptManager.GetCallbackEventReference Metode

Definisi

Overload

GetCallbackEventReference(Control, String, String, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: