ClientScriptManager.GetPostBackEventReference 方法

參考

定義

命名空間:: System.Web.UI

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

傳回字串，該字串可用於用戶端事件中造成回傳給伺服器。

多載

GetPostBackEventReference(Control, String, Boolean)	傳回字串，以用於用戶端事件中造成回傳給伺服器。參考字串是由處理回傳的指定控制項和其他事件資訊的字串引數所定義。或者，註冊事件參考以進行驗證。
GetPostBackEventReference(PostBackOptions, Boolean)	傳回字串，該字串可用於用戶端事件中造成回傳給伺服器。指定的 PostBackOptions 物件會定義參考字串。或者，註冊事件參考以進行驗證。
GetPostBackEventReference(PostBackOptions)	傳回字串，該字串可用於用戶端事件中造成回傳給伺服器。指定的 PostBackOptions 執行個體會定義參考字串。
GetPostBackEventReference(Control, String)	傳回字串，該字串可用於用戶端事件中造成回傳給伺服器。參考字串是由處理回傳的指定控制項和其他事件資訊的字串引數所定義。

GetPostBackEventReference(Control, String, Boolean)

傳回字串，以用於用戶端事件中造成回傳給伺服器。參考字串是由處理回傳的指定控制項和其他事件資訊的字串引數所定義。或者，註冊事件參考以進行驗證。

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

參數

control: Control

在伺服器上處理回傳的伺服器 Control。

argument: String

要傳遞至 control 的選擇性引數字串。

registerForEventValidation: Boolean

true 表示註冊事件參考以進行驗證，否則為 false。

傳回

String

視為用戶端上的指令碼時，啟始回傳的字串。

例外狀況

ArgumentNullException

指定的 Control 為 null。

備註

若要實 IPostBackEventHandler 作的 Page 介面，請使用 @ Implements 指示詞。

當 GetPostBackEventReference 屬性為 false 時 UseSubmitBehavior ，方法可以與控制項搭配 Button 使用。在此案例中 GetPostBackEventReference ，方法會傳回控制項的 Button 用戶端回傳事件。

如果 registerForEventValidation 為 true，方法會 GetPostBackEventReference(PostBackOptions, Boolean) 呼叫 RegisterForEventValidation(String, String) 方法來註冊事件參考，以便向唯一的控制項識別碼註冊驗證，此識別碼代表正在產生事件的用戶端控制項。

另請參閱

適用於

GetPostBackEventReference(PostBackOptions, Boolean)

傳回字串，該字串可用於用戶端事件中造成回傳給伺服器。指定的 PostBackOptions 物件會定義參考字串。或者，註冊事件參考以進行驗證。

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

參數

options: PostBackOptions

定義回傳的 PostBackOptions。

registerForEventValidation: Boolean

true 表示註冊事件參考以進行驗證，否則為 false。

傳回

String

視為用戶端上的指令碼時，啟始用戶端回傳的字串。

例外狀況

ArgumentNullException

PostBackOptions 為 null。

備註

若要實 IPostBackEventHandler 作 Page 物件的介面，請使用 @ Implements 指示詞。

如果為 registerForEventValidationtrue ，方法會 GetPostBackEventReference(PostBackOptions, Boolean) 呼叫 RegisterForEventValidation(String, String) 方法來註冊事件參考，以唯一的控制項識別碼來驗證，此識別碼代表正在產生事件的用戶端控制項。

另請參閱

適用於

GetPostBackEventReference(PostBackOptions)

傳回字串，該字串可用於用戶端事件中造成回傳給伺服器。指定的 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

參數

options: PostBackOptions

定義回傳的 PostBackOptions。

傳回

String

視為用戶端上的指令碼時，啟始用戶端回傳的字串。

例外狀況

ArgumentNullException

PostBackOptions 參數為 null。

備註

若要實 IPostBackEventHandler 作的 Page 介面，請使用 @ Implements 指示詞。

另請參閱

適用於

GetPostBackEventReference(Control, String)

傳回字串，該字串可用於用戶端事件中造成回傳給伺服器。參考字串是由處理回傳的指定控制項和其他事件資訊的字串引數所定義。

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

參數

control: Control

在伺服器上處理回傳的伺服器 Control。

argument: String

傳遞至處理回傳之控制項的選擇性引數字串。

傳回

String

視為用戶端上的指令碼時，啟始回傳的字串。

例外狀況

ArgumentNullException

指定的 Control 為 null。

範例

下列程式碼範例示範如何使用 GetPostBackEventReference 方法。自訂控制項 MyControl 會實作 IPostBackEventHandler 介面。按一下頁面上的按鈕時， RaisePostBackEvent 會叫用自訂控制項的方法。

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

下列程式碼範例具有與前一個程式碼相同的功能，不同之處在于類別會實作 IPostBackEventHandler 介面， Page 而不是自訂控制項。

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

備註

若要實 IPostBackEventHandler 作的 Page 介面，請使用 @ Implements 指示詞。

另請參閱

適用於

ClientScriptManager.GetPostBackEventReference 方法

定義

多載

GetPostBackEventReference(Control, String, Boolean)

參數

傳回

例外狀況

備註

另請參閱

適用於

GetPostBackEventReference(PostBackOptions, Boolean)

參數

傳回

例外狀況

備註

另請參閱

適用於

GetPostBackEventReference(PostBackOptions)

參數

傳回

例外狀況

備註

另請參閱

適用於

GetPostBackEventReference(Control, String)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

意見反應

其他資源