Page.RegisterRequiresPostBack(Control) Метод

Определение

Регистрирует элемент управления, как элемент требующий обработки обратной передачи, когда страница передается обратно на сервер.

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

Регистрируемый элемент управления.

Исключения

Регистрируемый элемент управления не реализует интерфейс 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 Forms Server Control Model.

Регистрируйте элементы управления на странице в момент или до Page_PreRender события жизненного цикла страницы.

Применяется к

См. также раздел