Page.RegisterRequiresRaiseEvent(IPostBackEventHandler) 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

将 ASP.NET 服务器控件注册为需要在 Page 对象上处理控件时引发事件的控件。

public:
 virtual void RegisterRequiresRaiseEvent(System::Web::UI::IPostBackEventHandler ^ control);

public virtual void RegisterRequiresRaiseEvent (System.Web.UI.IPostBackEventHandler control);

abstract member RegisterRequiresRaiseEvent : System.Web.UI.IPostBackEventHandler -> unit
override this.RegisterRequiresRaiseEvent : System.Web.UI.IPostBackEventHandler -> unit

Public Overridable Sub RegisterRequiresRaiseEvent (control As IPostBackEventHandler)

参数

control

IPostBackEventHandler

要注册的控件。

示例

下面的代码示例使用 RegisterRequiresRaiseEvent 该方法将 Web 服务器控件注册 Button 为要求引发事件。 注册第一个Button控件后，可能会导致代码中声明的第二Button个控件帖子第一个按钮的单击事件的结果。

void DisplayUserName(Object sender, EventArgs ea) 
{
   Response.Write("Welcome to " + Server.HtmlEncode(userName.Text));
}
void RaiseEvent(Object sender, EventArgs ea)
{
   // Raise a post back event for a control.
   this.RaisePostBackEvent(userButton, "");
}
void Page_Load(Object sender, EventArgs ea)
{
   // Register a control as one that requires postback handling.
   this.RegisterRequiresRaiseEvent(userButton);
}

    Sub DisplayUserName(Sender As Object, e As EventArgs) 
       Response.Write("Welcome to " + Server.HtmlEncode(userName.Text))
    End Sub

   Sub MyRaiseEvent(Sender As Object, e As EventArgs)
       'Raises a post back event for a control.
        Me.RaisePostBackEvent(userButton, "")
   End Sub 
    
    Sub Page_Load(Sender As Object, e As EventArgs)

      'Registers a control as one that requires postback handling
      Me.RegisterRequiresRaiseEvent(userButton)
  End Sub

注解

每个页面请求只能注册一个服务器控件。 RegisterRequiresRaiseEvent当控件不包含其控件 ID 的形式帖子数据时，必须使用该 ID。 此外，已注册的控件必须实现 IPostBackEventHandler 接口。

另请参阅

• IsPostBack