ClientScriptManager.GetPostBackEventReference Yöntem

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.dll

Sunucuya geri göndermeye neden olmak için istemci olayında kullanılabilecek bir dize döndürür.

Aşırı Yüklemeler

GetPostBackEventReference(Control, String, Boolean)	Sunucuya geri göndermeye neden olmak için istemci olayında kullanılacak bir dize döndürür. Başvuru dizesi, ek olay bilgilerinin geri göndermesini ve dize bağımsız değişkenini işleyen belirtilen denetim tarafından tanımlanır. İsteğe bağlı olarak, doğrulama için olay başvuruyu kaydeder.
GetPostBackEventReference(PostBackOptions, Boolean)	Sunucuya geri göndermeye neden olmak için istemci olayında kullanılabilecek bir dize döndürür. Başvuru dizesi belirtilen PostBackOptions nesne tarafından tanımlanır. İsteğe bağlı olarak, doğrulama için olay başvuruyu kaydeder.
GetPostBackEventReference(PostBackOptions)	Sunucuya geri göndermeye neden olmak için istemci olayında kullanılabilecek bir dize döndürür. Başvuru dizesi belirtilen PostBackOptions örnek tarafından tanımlanır.
GetPostBackEventReference(Control, String)	Sunucuya geri göndermeye neden olmak için istemci olayında kullanılabilecek bir dize döndürür. Başvuru dizesi, ek olay bilgilerinin geri göndermesini ve dize bağımsız değişkenini işleyen belirtilen denetim tarafından tanımlanır.

GetPostBackEventReference(Control, String, Boolean)

Sunucuya geri göndermeye neden olmak için istemci olayında kullanılacak bir dize döndürür. Başvuru dizesi, ek olay bilgilerinin geri göndermesini ve dize bağımsız değişkenini işleyen belirtilen denetim tarafından tanımlanır. İsteğe bağlı olarak, doğrulama için olay başvuruyu kaydeder.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::Control ^ control, System::String ^ argument, bool registerForEventValidation);

public string GetPostBackEventReference (System.Web.UI.Control control, string argument, bool registerForEventValidation);

member this.GetPostBackEventReference : System.Web.UI.Control * string * bool -> string

Public Function GetPostBackEventReference (control As Control, argument As String, registerForEventValidation As Boolean) As String

Parametreler

control

Control

Sunucuda Control geri göndermeyi işleyen sunucu.

argument

String

öğesine geçirecek controlisteğe bağlı bağımsız değişkenlerin dizesi.

registerForEventValidation

Boolean

true doğrulama için olay başvuruyu kaydetmek için; aksi takdirde , false.

Döndürülenler

String

İstemcide betik olarak kabul edildiğinde geri göndermeyi başlatan bir dize.

Özel durumlar

ArgumentNullException

Belirtilen Control değeridir null.

Açıklamalar

arabirimini IPostBackEventHandlerPageuygulamak için yönergesini @ Implements kullanın.

GetPostBackEventReference yöntemi, özelliği falseolduğunda UseSubmitBehavior denetimiyle Button birlikte kullanılabilir. Bu senaryoda yöntemi, GetPostBackEventReference denetim için Button istemci geri gönderme olayını döndürür.

registerForEventValidation True ise, GetPostBackEventReference(PostBackOptions, Boolean) yöntemi doğrulama için olay başvuruyu olayı oluşturan istemci denetimini temsil eden benzersiz bir denetim kimliğiyle kaydetmek için yöntemini çağırırRegisterForEventValidation(String, String).

Ayrıca bkz.

• PostBackOptions
• IPostBackEventHandler
• ASP.NET Sayfalarda Geri Gönderme Olmadan İstemci Geri Çağırmaları

GetPostBackEventReference(PostBackOptions, Boolean)

Sunucuya geri göndermeye neden olmak için istemci olayında kullanılabilecek bir dize döndürür. Başvuru dizesi belirtilen PostBackOptions nesne tarafından tanımlanır. İsteğe bağlı olarak, doğrulama için olay başvuruyu kaydeder.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::PostBackOptions ^ options, bool registerForEventValidation);

public string GetPostBackEventReference (System.Web.UI.PostBackOptions options, bool registerForEventValidation);

member this.GetPostBackEventReference : System.Web.UI.PostBackOptions * bool -> string

Public Function GetPostBackEventReference (options As PostBackOptions, registerForEventValidation As Boolean) As String

Parametreler

options

PostBackOptions

PostBackOptions Geri göndermeyi tanımlayan bir.

registerForEventValidation

Boolean

true doğrulama için olay başvuruyu kaydetmek için; aksi takdirde , false.

Döndürülenler

String

İstemcide betik olarak kabul edildiğinde istemci geri göndermesini başlatan bir dize.

Özel durumlar

ArgumentNullException

şeklindedir PostBackOptionsnull.

Açıklamalar

Bir Page nesnenin arabirimini IPostBackEventHandler uygulamak için yönergesini @ Implements kullanın.

GetPostBackEventReference yöntemi, özelliği falseolduğunda UseSubmitBehavior denetimiyle Button birlikte kullanılabilir. Bu senaryoda yöntemi, GetPostBackEventReference denetim için Button istemci geri gönderme olayını döndürür.

ise registerForEventValidationtrueyöntemi, GetPostBackEventReference(PostBackOptions, Boolean) doğrulama için olay başvuruyu olayı oluşturan istemci denetimini temsil eden benzersiz bir denetim kimliğiyle kaydetmek için yöntemini çağırır RegisterForEventValidation(String, String) .

Ayrıca bkz.

• PostBackOptions
• IPostBackEventHandler
• Button
• ASP.NET Sayfalarda Geri Gönderme Olmadan İstemci Geri Çağırmaları

GetPostBackEventReference(PostBackOptions)

Sunucuya geri göndermeye neden olmak için istemci olayında kullanılabilecek bir dize döndürür. Başvuru dizesi belirtilen PostBackOptions örnek tarafından tanımlanır.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::PostBackOptions ^ options);

public string GetPostBackEventReference (System.Web.UI.PostBackOptions options);

member this.GetPostBackEventReference : System.Web.UI.PostBackOptions -> string

Public Function GetPostBackEventReference (options As PostBackOptions) As String

Parametreler

options

PostBackOptions

PostBackOptions Geri göndermeyi tanımlayan bir.

Döndürülenler

String

İstemcide betik olarak kabul edildiğinde istemci geri göndermesini başlatan bir dize.

Özel durumlar

ArgumentNullException

PostBackOptions parametresi şu şekildedir:null

Açıklamalar

arabirimini IPostBackEventHandlerPageuygulamak için yönergesini @ Implements kullanın.

GetPostBackEventReference yöntemi, özelliği falseolduğunda UseSubmitBehavior denetimiyle Button birlikte kullanılabilir. Bu senaryoda yöntemi, GetPostBackEventReference denetim için Button istemci geri gönderme olayını döndürür.

Ayrıca bkz.

• PostBackOptions
• IPostBackEventHandler
• Button
• ASP.NET Sayfalarda Geri Gönderme Olmadan İstemci Geri Çağırmaları

GetPostBackEventReference(Control, String)

Sunucuya geri göndermeye neden olmak için istemci olayında kullanılabilecek bir dize döndürür. Başvuru dizesi, ek olay bilgilerinin geri göndermesini ve dize bağımsız değişkenini işleyen belirtilen denetim tarafından tanımlanır.

public:
 System::String ^ GetPostBackEventReference(System::Web::UI::Control ^ control, System::String ^ argument);

public string GetPostBackEventReference (System.Web.UI.Control control, string argument);

member this.GetPostBackEventReference : System.Web.UI.Control * string -> string

Public Function GetPostBackEventReference (control As Control, argument As String) As String

Parametreler

control

Control

Sunucuda Control geri göndermeyi işleyen sunucu.

argument

String

Geri göndermeyi işleyen denetime geçirmek için isteğe bağlı bağımsız değişkenler dizesi.

Döndürülenler

String

İstemcide betik olarak kabul edildiğinde geri göndermeyi başlatan bir dize.

Özel durumlar

ArgumentNullException

Belirtilen Control değeridir null.

Örnekler

Aşağıdaki kod örneği yönteminin GetPostBackEventReference kullanımını gösterir. özel denetimi, MyControlarabirimini IPostBackEventHandler uygular. Sayfadaki düğmeye tıklandığında, RaisePostBackEvent özel denetimin yöntemi çağrılır.

<%@ Page Language="C#"  %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  public class MyControl : Label, IPostBackEventHandler
  {

    // Use the constructor to defined default label text.
    public MyControl()
    {
      base.Text = "No postback raised.";
    }
    
    // Implement the RaisePostBackEvent method from the
    // IPostBackEventHandler interface. 
    public void RaisePostBackEvent(string eventArgument)
    {
      base.Text = "Postback handled by " + this.ID.ToString() + ". <br/>" +
                  "Postback caused by " + eventArgument.ToString() + ".";
      
    }
  }

  protected void Page_Load(object sender, EventArgs e)
  {
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;

    // Create an instance of the custom label control and 
    // add it to the page.
    MyControl mycontrol = new MyControl();
    mycontrol.ID = "mycontrol1";
    PlaceHolder1.Controls.Add(mycontrol);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a button element with its onClick attribute defined
    // to create a postback event reference to the custom label control.
    HtmlInputButton b = new HtmlInputButton();
    b.ID = "mybutton1";
    b.Value = "Click";
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(mycontrol, b.ID.ToString()));
    PlaceHolder1.Controls.Add(b);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a link element with its href attribute defined
    // to create a postback event reference to the custom label control.
    HtmlAnchor a = new HtmlAnchor();
    a.ID = "myanchor1";
    a.InnerText = "link";
    a.HRef = cs.GetPostBackClientHyperlink(mycontrol, a.ID.ToString());
    PlaceHolder1.Controls.Add(a);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
  Public Class MyControl
    Inherits Label
    Implements IPostBackEventHandler
     
    Public Sub New()
      
      MyBase.Text = "No postback raised."
    
    End Sub
    
    Public Sub RaisePostBackEvent(ByVal eventArgument As String) Implements System.Web.UI.IPostBackEventHandler.RaisePostBackEvent
      
      MyBase.Text = "Postback handled by " & Me.ID.ToString() & ". <br/>" & _
                "Postback caused by " + eventArgument.ToString() & "."

    End Sub
    
  End Class
   

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = Page.ClientScript

    ' Create an instance of the custom label control and 
    ' add it to the page.
    Dim mycontrol As New MyControl()
    MyControl.ID = "mycontrol1"
    PlaceHolder1.Controls.Add(MyControl)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a button element with its onClick attribute defined
    ' to create a postback event reference to the custom label control.
    Dim b As New HtmlInputButton()
    b.ID = "mybutton1"
    b.Value = "Click"
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(MyControl, b.ID.ToString()))
    PlaceHolder1.Controls.Add(b)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a link element with its href attribute defined
    ' to create a postback event reference to the custom label control.
    Dim a As New HtmlAnchor()
    a.ID = "myanchor1"
    a.InnerText = "link"
    a.HRef = cs.GetPostBackClientHyperlink(MyControl, a.ID.ToString())
    PlaceHolder1.Controls.Add(a)
    
  End Sub
</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>
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>

Aşağıdaki kod örneği, özel denetim Page yerine sınıfın arabirimi uygulaması IPostBackEventHandler dışında öncekiyle aynı işlevselliğe sahiptir.

<%@ Page Language="C#"  %>
<%@ Implements Interface="System.Web.UI.IPostBackEventHandler" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  
  public void RaisePostBackEvent(string eventArgument)
  {
    Label1.Text = "Postback handled by " + this.ID.ToString() + ". <br/>" +
                  "Postback caused by " + eventArgument.ToString() + "."; ;
  }
  
  protected void Page_Load(object sender, EventArgs e)
  {
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;
    
    // Create a button element with its onClick attribute defined
    // to create a postback event reference to the custom label control.
    HtmlInputButton b = new HtmlInputButton();
    b.ID = "mybutton1";
    b.Value = "Click";
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(this, b.ID.ToString()));
    PlaceHolder1.Controls.Add(b);
    PlaceHolder1.Controls.Add(new LiteralControl("<br/>"));
    
    // Create a link element with its href attribute defined
    // to create a postback event reference to the custom label control.
    HtmlAnchor a = new HtmlAnchor();
    a.ID = "myanchor1";
    a.InnerText = "link";
    a.HRef = cs.GetPostBackClientHyperlink(this, a.ID.ToString());
    PlaceHolder1.Controls.Add(a);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1"
                 runat="server" />
      <br />
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ Implements Interface="System.Web.UI.IPostBackEventHandler" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 
  Public Sub RaisePostBackEvent(ByVal eventArgument As String) _
    Implements IPostBackEventHandler.RaisePostBackEvent
    
    Label1.Text = "Postback handled by " & Me.ID.ToString() & ". <br/>" & _
           "Postback caused by " + eventArgument.ToString() & "."
  
  End Sub
  

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = Page.ClientScript
    
    ' Create a button element with its onClick attribute defined
    ' to create a postback event reference to the custom label control.
    Dim b As New HtmlInputButton()
    b.ID = "mybutton1"
    b.Value = "Click"
    b.Attributes.Add("onclick", cs.GetPostBackEventReference(Me, b.ID.ToString()))
    PlaceHolder1.Controls.Add(b)
    PlaceHolder1.Controls.Add(New LiteralControl("<br/>"))
    
    ' Create a link element with its href attribute defined
    ' to create a postback event reference to the custom label control.
    Dim a As New HtmlAnchor()
    a.ID = "myanchor1"
    a.InnerText = "link"
    a.HRef = cs.GetPostBackClientHyperlink(Me, a.ID.ToString())
    PlaceHolder1.Controls.Add(a)
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ClientScriptManager Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1"
                 runat="server" />
      <br />
      <asp:PlaceHolder id="PlaceHolder1" 
                       runat="server">
      </asp:PlaceHolder>
    </div>
    </form>
</body>
</html>

Açıklamalar

arabirimini IPostBackEventHandlerPageuygulamak için yönergesini @ Implements kullanın.

GetPostBackEventReference yöntemi, özelliği falseolduğunda UseSubmitBehavior denetimiyle Button birlikte kullanılabilir. Bu senaryoda yöntemi, GetPostBackEventReference denetim için Button istemci geri gönderme olayını döndürür.

Ayrıca bkz.

• PostBackOptions
• IPostBackEventHandler
• ASP.NET Sayfalarda Geri Gönderme Olmadan İstemci Geri Çağırmaları