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

Definition

Registriert ein Steuerelement als Steuerelement, für das Postbackbehandlung erforderlich ist, wenn die Seite an den Server zurückgesendet wird.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

Parameter

control
Control Control Control

Das zu registrierende Steuerelement.The control to be registered.

Ausnahmen

Das zu registrierende Steuerelement implementiert nicht die IPostBackDataHandler-Schnittstelle.The control to register does not implement the IPostBackDataHandler interface.

Beispiele

Im folgenden Codebeispiel wird die RegisterRequiresPostBack -Methode verwendet, um zu erzwingen, myTextBoxdass ein Textfeld-Steuerelement,, zurückgesendet werden muss, bevor der dem Textfeld zugeordnete Code ausgeführt werden kann.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. TextBoxSteuerelemente implementieren IPostBackDataHandler die-Schnittstelle.TextBox controls implement the IPostBackDataHandler interface.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.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

Hinweise

Das zu registrierende Steuerelement muss die IPostBackDataHandler -Schnittstelle HttpException implementieren, oder eine wird ausgelöst.The control to be registered must implement the IPostBackDataHandler interface or an HttpException is raised. Bei der Implementierung durch ein-Steuer IPostBackDataHandler Element ermöglicht die-Schnittstelle die Verarbeitung von Post Back Daten und das Bereitstellen von Änderungs Ereignissen für Postback-Daten.When implemented by a control, the IPostBackDataHandler interface enables handling of post back data and raising of any post back data changed events. Weitere Informationen zum Server Steuerungs Ereignis Modell finden Sie unter ASP.net Web Forms-Serversteuerelement Event Model.For more information on the server control event model, see ASP.NET Web Forms Server Control Event Model.

Registrieren Sie Steuerelemente mit der Seite am oder Page_PreRender vor dem-Ereignis des Lebenszyklus der Seite.Register controls with the page at or before the Page_PreRender event of the page life cycle.

Gilt für:

Siehe auch