Page.RegisterRequiresPostBack(Control) Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Regista um controlo como um que requer tratamento de postback quando a página é publicada 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 controlo a ser registado.

Exceções

HttpException

O controlo para registar não implementa a IPostBackDataHandler interface.

Exemplos

O exemplo seguinte de código usa o RegisterRequiresPostBack método para exigir que um controlo de caixa de texto, myTextBox, seja publicado de volta antes de qualquer código associado à caixa de texto poder ser executado. TextBox Os controlos implementam a IPostBackDataHandler interface.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.

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

Observações

O controlo a registar deve implementar a IPostBackDataHandler interface ou um HttpException é elevado. Quando implementada por um controlo, a IPostBackDataHandler interface permite o tratamento de dados de pós-retorno e a criação de quaisquer eventos alterados de dados de pós-retorno. Para mais informações sobre o modelo de eventos de controlo de servidor, veja ASP.NET Web Forms Server Control Event Model.

Controlo de registo com a página no momento ou antes Page_PreRender do evento do ciclo de vida da página.

Aplica-se a

Ver também