Page.RegisterRequiresPostBack(Control) Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Registra um controle como um controle que requer manipulação de postback quando é feito o postback da página para o servidor.

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)

Parâmetros

control
Control

O controle a ser registrado.

Exceções

HttpException

O controle a ser registrado não implementa a interface IPostBackDataHandler.

Exemplos

O exemplo de código a seguir usa o RegisterRequiresPostBack método para exigir um controle de caixa de texto, myTextBoxa ser postado novamente antes que qualquer código associado à caixa de texto possa ser executado. TextBox controles implementam a IPostBackDataHandler interface.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma ameaça à segurança em potencial. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

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

Comentários

O controle a ser registrado deve implementar a IPostBackDataHandler interface ou um HttpException é gerado. Quando implementada por um controle, a interface permite o IPostBackDataHandler tratamento de dados pós-back e a criação de quaisquer eventos de alteração de dados pós-back. Para obter mais informações sobre o modelo de evento de controle do servidor, consulte ASP.NET Web Forms Modelo de Evento de Controle de Servidor.

Registre controles com a página em ou antes do Page_PreRender evento do ciclo de vida da página.

Aplica-se a

Confira também