Page.RegisterRequiresPostBack(Control) Método

Definição

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

Registra um controle como aquele que requer tratamento de postback quando a página é postada de volta no 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 IPostBackDataHandler interface.

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 os controles implementam a IPostBackDataHandler interface.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma potencial ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos de script ou HTML. Para obter mais informações, consulte Visão geral das 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 a IPostBackDataHandler manipulação 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 Server Control Event Model.

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