Page.RegisterRequiresPostBack(Control) Método

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.dll

Registra un control como uno que requiere el control de postback cuando la página se devuelve al 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

Control que se va a registrar.

Excepciones

HttpException

El control que se va a registrar no implementa la IPostBackDataHandler interfaz .

Ejemplos

En el ejemplo de código siguiente se usa el RegisterRequiresPostBack método para requerir que se devuelva un control de cuadro de texto, myTextBox, antes de que se pueda ejecutar cualquier código asociado al cuadro de texto. TextBox los controles implementan la IPostBackDataHandler interfaz .

Importante

Este ejemplo tiene un cuadro de texto que acepta la entrada del usuario, que es una amenaza de seguridad potencial. De forma predeterminada, ASP.NET páginas web validan que la entrada del usuario no incluye elementos HTML ni de script. Para obtener más información, consulte Información general sobre vulnerabilidades de seguridad 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

Comentarios

El control que se va a registrar debe implementar la IPostBackDataHandler interfaz o se genera .HttpException Cuando se implementa mediante un control, la IPostBackDataHandler interfaz permite el control de los datos posteriores y la generación de los eventos modificados de los datos posteriores. Para obtener más información sobre el modelo de eventos de control de servidor, vea ASP.NET Web Forms Server Control Event Model.

Registre controles con la página en o antes del Page_PreRender evento del ciclo de vida de la página.

Se aplica a

Consulte también