Page.RegisterRequiresPostBack(Control) 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

將控制項註冊為，當頁面回傳給伺服器時，需要回傳處理的控制項。

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

要登錄的控制項。

例外狀況

HttpException

要註冊的控制項不會實作 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伺服器控制事件模型。

在頁面生命週期事件之前 Page_PreRender ，向頁面註冊控制項。

另請參閱

• IsPostBack
• IPostBackDataHandler
• ASP.NET 網頁生命週期簡介
• ASP.NET 伺服器控制事件模型