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 控件必须实现接口或 HttpException 引发控件。 当由控件实现时，该 IPostBackDataHandler 接口支持处理回发数据并引发任何回发数据更改事件。 有关服务器控制事件模型的详细信息，请参阅ASP.NET Web Forms服务器控制事件模型。

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

适用于

另请参阅