Page.RegisterRequiresPostBack(Control) Methode

Definitie

Naamruimte:
System.Web.UI
Assembly:
System.Web.dll

Registreert een besturingselement als een besturingselement waarvoor een postback-verwerking is vereist wanneer de pagina wordt teruggezet naar de 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
Public Sub RegisterRequiresPostBack (control As Control)

Parameters

control
Control

Het besturingselement dat moet worden geregistreerd.

Uitzonderingen

HttpException

Het besturingselement dat moet worden geregistreerd, implementeert de IPostBackDataHandler interface niet.

Voorbeelden

In het volgende codevoorbeeld wordt de methode gebruikt voor het RegisterRequiresPostBack vereisen van een tekstvak, myTextBoxdie moet worden teruggezet voordat code die aan het tekstvak is gekoppeld, kan worden uitgevoerd. TextBox besturingselementen implementeren de IPostBackDataHandler interface.

Important

Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.

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

Opmerkingen

Het besturingselement dat moet worden geregistreerd, moet de IPostBackDataHandler interface of een HttpException verhoogde interface implementeren. Wanneer deze wordt geïmplementeerd door een besturingselement, maakt de interface het IPostBackDataHandler mogelijk om postback-gegevens te verwerken en eventuele gewijzigde gebeurtenissen voor postback-gegevens op te halen. Zie ASP.NET Web Forms Server Control Event Model voor meer informatie over het gebeurtenismodel voor serverbeheer.

Registreer besturingselementen bij de pagina bij of vóór de gebeurtenis van de Page_PreRender levenscyclus van de pagina.

Van toepassing op

Zie ook