ClientScriptManager.GetCallbackEventReference Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.UI

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Çağrıldığında bir sunucu olayına istemci çağrısı başlatan bir istemci işlevine başvuru alır.

Aşırı Yüklemeler

GetCallbackEventReference(Control, String, String, String)	Çağrıldığında bir sunucu olayına istemci çağrısı başlatan bir istemci işlevine başvuru alır. Bu aşırı yüklenmiş yöntemin istemci işlevi belirtilen denetimi, bağımsız değişkeni, istemci betiğini ve bağlamı içerir.
GetCallbackEventReference(Control, String, String, String, Boolean)	Çağrıldığında sunucu olaylarına yönelik bir istemci çağrısı başlatan bir istemci işlevine başvuru alır. Bu aşırı yüklenmiş yöntemin istemci işlevi, belirtilen bir denetim, bağımsız değişken, istemci betiği, bağlam ve Boole değeri içerir.
GetCallbackEventReference(String, String, String, String, String, Boolean)	Çağrıldığında sunucu olaylarına yönelik bir istemci çağrısı başlatan bir istemci işlevine başvuru alır. Bu aşırı yüklenmiş yöntemin istemci işlevi belirtilen bir hedef, bağımsız değişken, istemci betiği, bağlam, hata işleyicisi ve Boole değeri içerir.
GetCallbackEventReference(Control, String, String, String, String, Boolean)	Çağrıldığında sunucu olaylarına yönelik bir istemci çağrısı başlatan bir istemci işlevine başvuru alır. Bu aşırı yüklenmiş yöntemin istemci işlevi, belirtilen bir denetim, bağımsız değişken, istemci betiği, bağlam, hata işleyicisi ve Boole değeri içerir.

GetCallbackEventReference(Control, String, String, String)

Çağrıldığında bir sunucu olayına istemci çağrısı başlatan bir istemci işlevine başvuru alır. Bu aşırı yüklenmiş yöntemin istemci işlevi belirtilen denetimi, bağımsız değişkeni, istemci betiğini ve bağlamı içerir.

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

Parametreler

control: Control

İstemci geri çağırmasını işleyen sunucu Control . Denetimin arabirimini ICallbackEventHandler uygulaması ve bir RaiseCallbackEvent(String) yöntem sağlaması gerekir.

argument: String

İstemci betiğinden sunucuya geçirilen bir bağımsız değişken

RaiseCallbackEvent(String) Yöntem.

clientCallback: String

Başarılı sunucu olayının sonucunu alan istemci olay işleyicisinin adı.

context: String

Geri çağırmayı başlatmadan önce istemcide değerlendirilen istemci betiği. Betiğin sonucu istemci olay işleyicisine geri geçirilir.

Döndürülenler

String

İstemci geri çağırmasını çağıran bir istemci işlevinin adı.

Özel durumlar

ArgumentNullException

Belirtilen Control değeridir null.

InvalidOperationException

Belirtilen Control arabirimi uygulamaz ICallbackEventHandler .

Örnekler

Aşağıdaki kod örneği, tamsayıları artıran bir istemci geri çağırma senaryosunda yönteminin iki aşırı yüklemesinin GetCallbackEventReference nasıl kullanılacağını gösterir.

İki geri çağırma mekanizması gösterilir; aralarındaki fark parametresinin context kullanılmasıdır. ReceiveServerData1 parametresi kullanılarak context bir istemci geri çağırma işlevi sağlanır. Buna karşılık, ReceiveServerData2 istemci geri çağırma işlevi sayfadaki bir <script> blokta tanımlanır. RaiseCallbackEvent Yöntem, ona geçirilen değeri artıran sunucu işleyicisidir ve GetCallbackResult yöntemi artımlı değeri dize olarak döndürür. RaiseCallbackEvent Yöntem bir hata döndürürse istemci ProcessCallBackError işlevi çağrılır.

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

Açıklamalar

yöntemi, GetCallbackEventReference(Control, String, String, String) bir sayfanın normal yaşam döngüsünün değiştirilmiş bir sürümü olan sunucuya bant dışı bir geri çağırma gerçekleştirir. Daha fazla bilgi için bkz. Geri Gönderme Olmadan İstemci Geri Çağırmaları Uygulama.

Not

Tarayıcı Microsoft Internet Explorer (sürüm 5.0 veya üzeri) olduğunda, betik geri çağırma mekanizması Microsoft.XmlHttp COM nesnesi aracılığıyla uygulanır ve tarayıcının ActiveX denetimlerini çalıştıracak şekilde ayarlanmasını gerektirir. Diğer tarayıcılar için, tarayıcının yerel Belge Nesne Modeli 'ni (DOM) kullanan bir XMLHttpRequest kullanılır. Tarayıcının istemci geri çağırmalarını destekleyip desteklemediğini denetlemek için özelliğini kullanın SupportsCallback . Tarayıcının SupportsXmlHttp HTTP üzerinden XML'yi destekleyip desteklemediğini denetlemek için özelliğini kullanın. Her iki özelliğe de iç ASP.NET Request nesnesinin özelliği aracılığıyla Browser erişilebilir.

GetCallbackEventReference yönteminin GetCallbackEventReference aşırı yüklemesi, HTTP üzerinden XML kullanarak zaman uyumlu bir geri çağırma gerçekleştirir. Bir geri çağırma senaryosunda verileri zaman uyumlu olarak gönderirken, zaman uyumlu geri çağırmalar hemen geri döner ve tarayıcıyı engellemez. Tarayıcıda hiçbir zaman uyumlu geri çağırma işlemi aynı anda yürütülemez. Biri şu anda beklemedeyken ikinci bir zaman uyumlu geri çağırma tetiklenirse, ikinci zaman uyumlu geri çağırma ilki iptal eder ve yalnızca ikinci geri arama geri döner.

Verileri zaman uyumsuz olarak göndermek için, bu davranışı denetleyen boole değeri olan parametresini useAsync alan aşırı yüklemelerden birini kullanın. Zaman uyumsuz senaryoda bekleyen birden çok geri çağırmanız olabilir; ancak iade ettikleri sıranın, başlatıldıkları sırayla eşleşmesi garanti değildir.

Ayrıca, yönteminin GetCallbackEventReference bu aşırı yüklemesi, yöntemi tarafından RaiseCallbackEvent oluşturulan bir hata koşulunun durumunu işlemek için hiçbir istemci işlevi belirtir. İstemci hatası geri çağırma işleyicisini belirtmek için parametresini alan clientErrorCallback aşırı yüklemelerden birini kullanın.

GetCallbackEventReference(Control, String, String, String) yöntemi isteğe bağlı bir dize argument parametresi alır ve bir dize döndürür. Birden çok değer geçirmek veya almak için, sırasıyla giriş veya dönüş dizesindeki değerleri birleştirin.

Not

Betik geri çağırma işlemleri sırasında güncelleştirilmesi gereken sayfa veya denetim özelliklerinin uygulanmasında görünüm durumunu kullanmaktan kaçının. Özellikler sayfa isteklerine devam edecekse oturum durumunu kullanabilirsiniz.

Ayrıca bkz.

Şunlara uygulanır

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

Çağrıldığında sunucu olaylarına yönelik bir istemci çağrısı başlatan bir istemci işlevine başvuru alır. Bu aşırı yüklenmiş yöntemin istemci işlevi, belirtilen bir denetim, bağımsız değişken, istemci betiği, bağlam ve Boole değeri içerir.

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

Parametreler

control: Control

İstemci geri çağırmasını işleyen sunucu Control . Denetimin arabirimini ICallbackEventHandler uygulaması ve bir RaiseCallbackEvent(String) yöntem sağlaması gerekir.

argument: String

İstemci betiğinden sunucuya geçirilen bir bağımsız değişken

RaiseCallbackEvent(String) Yöntem.

clientCallback: String

Başarılı sunucu olayının sonucunu alan istemci olay işleyicisinin adı.

context: String

Geri çağırmayı başlatmadan önce istemcide değerlendirilen istemci betiği. Betiğin sonucu istemci olay işleyicisine geri geçirilir.

useAsync: Boolean

true geri çağırmayı zaman uyumsuz olarak gerçekleştirmek için; false geri çağırmayı zaman uyumlu olarak gerçekleştirmek için.

Döndürülenler

String

İstemci geri çağırmasını çağıran bir istemci işlevinin adı.

Özel durumlar

ArgumentNullException

Belirtilen Control değeridir null.

InvalidOperationException

Belirtilen Control arabirimi uygulamaz ICallbackEventHandler .

Açıklamalar

yönteminin GetCallbackEventReference bu aşırı yüklemesi, değerini trueolarak ayarlayarak istemci geri çağırmasını zaman uyumsuz olarak gerçekleştirmenizi sağlayan bir useAsync parametre gerektirir. Parametre gerektirmeyen bu yöntemin useAsync aşırı yükleme sürümleri varsayılan olarak değerini olarak false ayarlar.

Bu yöntem hakkında daha fazla bilgi için aşırı yükleme GetCallbackEventReference yöntemine yönelik açıklamalara bakın.

Ayrıca bkz.

Şunlara uygulanır

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

Çağrıldığında sunucu olaylarına yönelik bir istemci çağrısı başlatan bir istemci işlevine başvuru alır. Bu aşırı yüklenmiş yöntemin istemci işlevi belirtilen bir hedef, bağımsız değişken, istemci betiği, bağlam, hata işleyicisi ve Boole değeri içerir.

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

Parametreler

target: String

İstemci geri çağırmasını işleyen sunucunun Control adı. Denetimin arabirimini ICallbackEventHandler uygulaması ve bir RaiseCallbackEvent(String) yöntem sağlaması gerekir.

argument: String

İstemci betiğinden sunucuya geçirilen bir bağımsız değişken

RaiseCallbackEvent(String) Yöntem.

clientCallback: String

Başarılı sunucu olayının sonucunu alan istemci olay işleyicisinin adı.

context: String

Geri çağırmayı başlatmadan önce istemcide değerlendirilen istemci betiği. Betiğin sonucu istemci olay işleyicisine geri geçirilir.

clientErrorCallback: String

Sunucu olay işleyicisinde bir hata oluştuğunda sonucu alan istemci olay işleyicisinin adı.

useAsync: Boolean

true geri çağırmayı zaman uyumsuz olarak gerçekleştirmek için; false geri çağırmayı zaman uyumlu olarak gerçekleştirmek için.

Döndürülenler

String

İstemci geri çağırmasını çağıran bir istemci işlevinin adı.

Örnekler

Aşağıdaki kod örneği, tamsayıları artıran bir istemci geri çağırma senaryosunda yönteminin iki aşırı yüklemesinin GetCallbackEventReference nasıl kullanılacağını gösterir.

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

Açıklamalar

Yönteminin GetCallbackEventReference bu aşırı yüklemesi parametre yerine bir targetControl dize parametresi alır. Geri çağırmanın denetimi içeren bir dize UniqueID dışında bir şeye geri gitmesini istediğinizde bu aşırı yüklemeyi kullanın.

Ayrıca, yönteminin GetCallbackEventReference bu aşırı yüklemesi bir useAsync ve clientErrorCallback parametresi gerektirir. parametresi, useAsync değerini trueolarak ayarlayarak istemci geri çağırmasını zaman uyumsuz olarak gerçekleştirmenize olanak tanır. Parametre gerektirmeyen bu yöntemin useAsync aşırı yükleme sürümleri varsayılan olarak değerini olarak false ayarlar. parametresi, clientErrorCallback sunucu işleyicisi olan yöntemi bir hata döndürürse çağrılan istemci işlevinin RaiseCallbackEvent adını tanımlamanızı sağlar. Parametre gerektirmeyen clientErrorCallback bu yöntemin aşırı yükleme sürümleri değeri null olarak ayarlar.

Bu yöntem hakkında daha fazla bilgi için aşırı yükleme GetCallbackEventReference yöntemine yönelik açıklamalara bakın.

Ayrıca bkz.

Şunlara uygulanı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

Parametreler

control: Control

İstemci geri çağırmasını işleyen sunucu Control . Denetimin arabirimini ICallbackEventHandler uygulaması ve bir RaiseCallbackEvent(String) yöntem sağlaması gerekir.

argument: String

İstemci betiğinden sunucu RaiseCallbackEvent(String) yöntemine geçirilen bir bağımsız değişken.

clientCallback: String

Başarılı sunucu olayının sonucunu alan istemci olay işleyicisinin adı.

context: String

Geri çağırmayı başlatmadan önce istemcide değerlendirilen istemci betiği. Betiğin sonucu istemci olay işleyicisine geri geçirilir.

clientErrorCallback: String

Sunucu olay işleyicisinde bir hata oluştuğunda sonucu alan istemci olay işleyicisinin adı.

useAsync: Boolean

true geri çağırmayı zaman uyumsuz olarak gerçekleştirmek için; false geri çağırmayı zaman uyumlu olarak gerçekleştirmek için.

Döndürülenler

String

İstemci geri çağırmasını çağıran bir istemci işlevinin adı.

Özel durumlar

ArgumentNullException

Belirtilen Control değeridir null.

InvalidOperationException

Belirtilen Control arabirimi uygulamaz ICallbackEventHandler .

Açıklamalar

Yönteminin GetCallbackEventReference bu aşırı yüklemesi için bir useAsync ve clientErrorCallback parametresi gerekir. parametresi, useAsync değerini trueolarak ayarlayarak istemci geri çağırmasını zaman uyumsuz olarak gerçekleştirmenize olanak tanır. Parametre gerektirmeyen bu yöntemin useAsync aşırı yükleme sürümleri varsayılan olarak değerini olarak false ayarlar. parametresi, clientErrorCallback sunucu işleyicisi (yöntem) bir hata döndürürse çağrılan istemci işlevinin RaiseCallbackEvent adını tanımlamanızı sağlar. Parametre gerektirmeyen clientErrorCallback bu yöntemin aşırı yükleme sürümleri değeri null olarak ayarlar.

Bu yöntem hakkında daha fazla bilgi için aşırı yükleme GetCallbackEventReference yöntemine yönelik açıklamalara bakın.

Ayrıca bkz.

Şunlara uygulanır

Aracılığıyla paylaş

ClientScriptManager.GetCallbackEventReference Yöntem

Tanım

Aşırı Yüklemeler

GetCallbackEventReference(Control, String, String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

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

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar