Page.RegisterRequiresRaiseEvent(IPostBackEventHandler) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Регистрирует серверный элемент управления 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 для регистрации 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 необходимо использовать, если элемент управления не содержит его идентификатор элемента управления в данные формы после публикации. Кроме того, зарегистрированный элемент управления должен реализовать IPostBackEventHandler интерфейс.