Page.RegisterRequiresPostBack(Control) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將控制項註冊為,當頁面回傳給伺服器時,需要回傳處理的控制項。
public:
void RegisterRequiresPostBack(System::Web::UI::Control ^ control);
public void RegisterRequiresPostBack (System.Web.UI.Control control);
member this.RegisterRequiresPostBack : System.Web.UI.Control -> unit
Public Sub RegisterRequiresPostBack (control As Control)
參數
- control
- Control
要登錄的控制項。
例外狀況
要註冊的控制項不會實作 IPostBackDataHandler 介面。
範例
下列程式代碼範例會 RegisterRequiresPostBack 使用 方法,要求在與文本框相關聯的任何程式代碼可以執行之前,先回傳文本框控件 myTextBox
。
TextBox 控件會實作 IPostBackDataHandler 介面。
重要
這個範例有一個可接受使用者輸入的文字方塊,這可能會造成安全性威脅。 根據預設,ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊,請參閱 Script Exploits Overview (指令碼攻擊概觀)。
protected void Text_Change(object sender, EventArgs e)
{
myLabel.Text = "<b>Welcome " + myTextBox.Text + " to ASP.NET</b>";
}
protected void Page_PreRender(object sender, EventArgs e)
{
this.RegisterRequiresPostBack(myTextBox);
}
Sub Text_Change(ByVal sender As Object, ByVal e As EventArgs)
myLabel.Text = "<b>Welcome " + myTextBox.Text + " to ASP.NET</b>"
End Sub 'Text_Change
Protected Sub Page_PreRender(ByVal sender As Object, ByVal e As System.EventArgs)
Me.RegisterRequiresPostBack(myTextBox)
End Sub
備註
要註冊的控制項必須實作 IPostBackDataHandler 介面或 HttpException 引發 。 由控件實作時, IPostBackDataHandler 介面可處理回傳數據,以及引發任何回傳數據變更事件。 如需伺服器控件事件模型的詳細資訊,請參閱 ASP.NET Web Forms Server Control 事件模型。
在頁面生命週期事件之前 Page_PreRender
,向頁面註冊控件。