ClientScriptManager.GetCallbackEventReference Yöntem

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

Name	Description
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 bir denetim, bağımsız değişken, istemci betiği 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 bir denetim, bağımsız değişken, istemci betiği 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 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ğırma 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öntemin 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öntem 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.

Uyarı

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üklenmesi, 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 geri çağırma aynı anda yürütülemez. Şu anda bekleyen ikinci bir zaman uyumlu geri çağırma tetiklenirse, ikinci zaman uyumlu geri çağırma ilki iptal eder ve yalnızca ikinci geri çağırma döndürülecektir.

Verileri zaman uyumsuz olarak göndermek için, bu davranışı denetleyen bir 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şleyicisi 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.

Uyarı

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 isteklerinde hayatta kalmak içinse 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 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ğırma 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 bir şekilde 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. Bu yöntemin parametre gerektirmeyen 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önteminin açıklamalarına 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 bir sunucunun Control adı. Denetimin arabirimini ICallbackEventHandler uygulaması ve bir RaiseCallbackEvent(String) yöntem sağlaması gerekir.

argument: String

İstemci betiğinden sunucuya geçirilen 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ğırma 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 bir şekilde 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öntemin 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 UniqueID bir dize dışında bir şeye geri dönmesini istediğinizde bu aşırı yüklemeyi kullanın.

Ayrıca, yöntemin 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ştirmenizi sağlar. Bu yöntemin parametre gerektirmeyen useAsync aşırı yükleme sürümleri varsayılan olarak değerini olarak false ayarlar. clientErrorCallback parametresi, 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. Bu yöntemin parametre gerektirmeyen clientErrorCallback 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önteminin açıklamalarına 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ğırma 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 bir şekilde 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ştirmenizi sağlar. Bu yöntemin parametre gerektirmeyen 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. Bu yöntemin parametre gerektirmeyen clientErrorCallback 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önteminin açıklamalarına bakın.

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

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

Geri Bildirim