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 网页验证用户输入是否不包含脚本或 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

注解

要注册的控件必须实现 接口或IPostBackDataHandlerHttpException引发 。 当由 控件实现时， IPostBackDataHandler 接口允许处理回发数据，并引发任何回发数据更改事件。 有关服务器控件事件模型的详细信息，请参阅 ASP.NET Web 窗体服务器控件事件模型。

在页面生命周期事件或页面生命周期事件之前向 Page_PreRender 页面注册控件。

另请参阅

• IsPostBack
• IPostBackDataHandler
• ASP.NET 页生命周期简介
• ASP.NET 服务器控件事件模型