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