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 события жизненного цикла страницы.

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

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