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 -> unitPublic 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
Комментарии
Зарегистрированный элемент управления должен реализовать IPostBackDataHandler интерфейс или HttpException вызывается. При реализации элементом управления IPostBackDataHandler интерфейс обеспечивает обработку данных обратной передачи и создание событий изменения измененных данных после обратной передачи. Дополнительные сведения о модели событий управления сервером см. в разделе ASP.NET Web Forms Модель событий управления сервером.
Регистрируйте элементы управления на странице или перед Page_PreRender событием жизненного цикла страницы.