ClientScriptManager.GetPostBackEventReference 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.

Mengembalikan string yang dapat digunakan dalam peristiwa klien untuk menyebabkan postback ke server.

Overload

GetPostBackEventReference(Control, String, Boolean)	Mengembalikan string yang akan digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh kontrol yang ditentukan yang menangani postback dan argumen string dari informasi peristiwa tambahan. Secara opsional, mendaftarkan referensi peristiwa untuk validasi.
GetPostBackEventReference(PostBackOptions, Boolean)	Mengembalikan string yang dapat digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh objek yang ditentukan PostBackOptions . Secara opsional, mendaftarkan referensi peristiwa untuk validasi.
GetPostBackEventReference(PostBackOptions)	Mengembalikan string yang dapat digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh instans yang ditentukan PostBackOptions .
GetPostBackEventReference(Control, String)	Mengembalikan string yang dapat digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh kontrol yang ditentukan yang menangani postback dan argumen string dari informasi peristiwa tambahan.

GetPostBackEventReference(Control, String, Boolean)

Mengembalikan string yang akan digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh kontrol yang ditentukan yang menangani postback dan argumen string dari informasi peristiwa tambahan. Secara opsional, mendaftarkan referensi peristiwa untuk validasi.

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

Parameter

control: Control

Server Control yang memproses postback di server.

argument: String

String argumen opsional untuk diteruskan ke control.

registerForEventValidation: Boolean

true untuk mendaftarkan referensi peristiwa untuk validasi; jika tidak, false.

Mengembalikan

String

String yang, ketika diperlakukan sebagai skrip pada klien, memulai postback.

Pengecualian

ArgumentNullException

Yang ditentukan Control adalah null.

Keterangan

Untuk mengimplementasikan IPostBackEventHandler antarmuka untuk Page, gunakan direktif @ Implements .

Metode GetPostBackEventReference ini dapat digunakan dengan Button kontrol ketika UseSubmitBehavior properti adalah false. Dalam skenario ini, GetPostBackEventReference metode mengembalikan peristiwa postback klien untuk Button kontrol.

Jika registerForEventValidation benar, GetPostBackEventReference(PostBackOptions, Boolean) metode memanggil RegisterForEventValidation(String, String) metode untuk mendaftarkan referensi peristiwa untuk validasi dengan ID kontrol unik yang mewakili kontrol klien yang menghasilkan peristiwa.

Lihat juga

Berlaku untuk

GetPostBackEventReference(PostBackOptions, Boolean)

Mengembalikan string yang dapat digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh objek yang ditentukan PostBackOptions . Secara opsional, mendaftarkan referensi peristiwa untuk validasi.

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

Parameter

options: PostBackOptions

PostBackOptions yang mendefinisikan postback.

registerForEventValidation: Boolean

true untuk mendaftarkan referensi peristiwa untuk validasi; jika tidak, false.

Mengembalikan

String

String yang, ketika diperlakukan sebagai skrip pada klien, memulai postback klien.

Pengecualian

ArgumentNullException

PostBackOptions adalah null.

Keterangan

Untuk mengimplementasikan IPostBackEventHandler antarmuka untuk Page objek, gunakan direktif @ Implements .

Jika registerForEventValidation adalah true, GetPostBackEventReference(PostBackOptions, Boolean) metode memanggil RegisterForEventValidation(String, String) metode untuk mendaftarkan referensi peristiwa untuk validasi dengan ID kontrol unik yang mewakili kontrol klien yang menghasilkan peristiwa.

Lihat juga

Berlaku untuk

GetPostBackEventReference(PostBackOptions)

Mengembalikan string yang dapat digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh instans yang ditentukan PostBackOptions .

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

Parameter

options: PostBackOptions

PostBackOptions yang mendefinisikan postback.

Mengembalikan

String

String yang, ketika diperlakukan sebagai skrip pada klien, memulai postback klien.

Pengecualian

ArgumentNullException

Parameternya PostBackOptions adalah null

Keterangan

Untuk mengimplementasikan IPostBackEventHandler antarmuka untuk Page, gunakan direktif @ Implements .

Lihat juga

Berlaku untuk

GetPostBackEventReference(Control, String)

Mengembalikan string yang dapat digunakan dalam peristiwa klien untuk menyebabkan postback ke server. String referensi ditentukan oleh kontrol yang ditentukan yang menangani postback dan argumen string dari informasi peristiwa tambahan.

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

Parameter

control: Control

Server Control yang memproses postback di server.

argument: String

String argumen opsional untuk diteruskan ke kontrol yang memproses postback.

Mengembalikan

String

String yang, ketika diperlakukan sebagai skrip pada klien, memulai postback.

Pengecualian

ArgumentNullException

Yang ditentukan Control adalah null.

Contoh

Contoh kode berikut menunjukkan penggunaan GetPostBackEventReference metode . Kontrol kustom, MyControl, mengimplementasikan IPostBackEventHandler antarmuka . Ketika tombol pada halaman diklik, RaisePostBackEvent metode kontrol kustom dipanggil.

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

Contoh kode berikut memiliki fungsionalitas yang sama dengan yang sebelumnya, kecuali bahwa alih-alih kontrol kustom, Page kelas mengimplementasikan IPostBackEventHandler antarmuka.

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

Keterangan

Untuk mengimplementasikan IPostBackEventHandler antarmuka untuk Page, gunakan direktif @ Implements .

Lihat juga

Berlaku untuk

Bagikan melalui

ClientScriptManager.GetPostBackEventReference Metode

Definisi

Overload

GetPostBackEventReference(Control, String, Boolean)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

GetPostBackEventReference(PostBackOptions, Boolean)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

GetPostBackEventReference(PostBackOptions)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

GetPostBackEventReference(Control, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: