Page.RegisterRequiresPostBack(Control) Método

Definición

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

El control que debe registrarse no implementa la interfaz IPostBackDataHandler.

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 datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante 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

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 controlar los datos posteriores y generar los eventos modificados de los datos de post back. Para obtener más información sobre el modelo de eventos de control de servidor, consulte ASP.NET modelo de eventos de control de servidor de Formularios Web Forms.

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