Page.RegisterRequiresPostBack(Control) Methode

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Registriert ein Steuerelement als Steuerelement, für das Postbackbehandlung erforderlich ist, wenn die Seite an den Server zurückgesendet wird.

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)

Parameter

control
Control

Das zu registrierende Steuerelement.

Ausnahmen

HttpException

Das zu registrierende Steuerelement implementiert nicht die IPostBackDataHandler-Schnittstelle.

Beispiele

Im folgenden Codebeispiel wird die RegisterRequiresPostBack Methode verwendet, um ein Textfeld-Steuerelement zu erfordern, das zurück gepostet werden soll, myTextBoxbevor code, der dem Textfeld zugeordnet ist, ausgeführt werden kann. TextBox Steuerelemente implementieren die IPostBackDataHandler Schnittstelle.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

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 implementieren oder ausgelöst HttpException werden. Bei der Implementierung durch ein Steuerelement ermöglicht die IPostBackDataHandler Schnittstelle die Behandlung von Postbackdaten und das Auslösen von Postbackdaten geänderten Ereignissen. Weitere Informationen zum Serversteuerelementereignismodell finden Sie unter ASP.NET Web Forms Serversteuerelement-Ereignismodell.

Registrieren Sie Steuerelemente mit der Seite bei oder vor dem Page_PreRender Ereignis des Seitenlebenszyklus.

Gilt für

Siehe auch