Page.RegisterRequiresPostBack(Control) Methode

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 gesendet wird, myTextBoxbevor code ausgeführt werden kann, der dem Textfeld zugeordnet ist. 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 ein HttpException wird ausgelöst. Wenn sie von einem Steuerelement implementiert wird, ermöglicht die Schnittstelle die IPostBackDataHandler Verarbeitung von Postback-Daten und das Auslösen von Nachback-Datenänderungen. Weitere Informationen zum Serversteuerelementereignismodell finden Sie unter ASP.NET Web Forms Server Control Event Model.

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

Gilt für:

Freigeben über