Compartilhar via


Page.RegisterRequiresPostBack(Control) Método

Definição

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

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 que um controle de caixa de texto, myTextBox, seja 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 possível ameaça à segurança. 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 geração de quaisquer eventos de alteração de dados pós-back. Para obter mais informações sobre o modelo de evento de controle de servidor, consulte ASP.NET Modelo de evento de controle de servidor do Web Forms.

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