Page.RegisterRequiresPostBack(Control) Page.RegisterRequiresPostBack(Control) Page.RegisterRequiresPostBack(Control) Method

Definición

Registra un control como un control que requiere el control de postback cuando la página se devuelva al servidor.Registers a control as one that requires postback handling when the page is posted back to the server.

public:
 void RegisterRequiresPostBack(System::Web::UI::Control ^ control);
public void RegisterRequiresPostBack (System.Web.UI.Control control);
member this.RegisterRequiresPostBack : System.Web.UI.Control -> unit

Parámetros

control
Control Control Control

Control que se va a registrar.The control to be registered.

Excepciones

El control que debe registrarse no implementa la interfaz IPostBackDataHandler.The control to register does not implement the IPostBackDataHandler interface.

Ejemplos

En el ejemplo de código siguiente RegisterRequiresPostBack se usa el método para requerir un control myTextBoxde cuadro de texto,, que se va a devolver antes de que se pueda ejecutar cualquier código asociado al cuadro de texto.The following code example uses the RegisterRequiresPostBack method to require a text box control, myTextBox, to be posted back before any code associated with the text box can execute. TextBoxlos controles implementan la IPostBackDataHandler interfaz.TextBox controls implement the IPostBackDataHandler interface.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad.This example has a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.For more information, see Script Exploits Overview.

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 IPostBackDataHandler implementar la interfaz HttpException o se produce una excepción.The control to be registered must implement the IPostBackDataHandler interface or an HttpException is raised. Cuando se implementa mediante un control, IPostBackDataHandler la interfaz permite el control de los datos de postback y la generación de los eventos de cambios de datos posteriores.When implemented by a control, the IPostBackDataHandler interface enables handling of post back data and raising of any post back data changed events. Para obtener más información sobre el modelo de eventos de control de servidor, vea ASP.NET control de servidor de formularios Web Forms modelo de eventos.For more information on the server control event model, see ASP.NET Web Forms Server Control Event Model.

Registre los controles con la página en o antes Page_PreRender del evento del ciclo de vida de la página.Register controls with the page at or before the Page_PreRender event of the page life cycle.

Se aplica a

Consulte también: