語言

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 。

Important

此範例中有一個文字框可接受使用者輸入，這可能構成安全威脅。 預設情況下，ASP.NET 網頁會驗證使用者輸入中不包含腳本或 HTML 元素。 欲了解更多資訊，請參閱 腳本漏洞概述。

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 否則 a HttpException 會被提出。 當由控制項實作時，介面 IPostBackDataHandler 能處理後回傳資料並檢索任何後回傳資料變更事件。 欲了解更多伺服器控制事件模型的資訊，請參閱 ASP.NET Web Forms 伺服器控制事件模型。

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

適用於

另請參閱