Page.RegisterRequiresPostBack-Methode

Artikel
08/20/2007

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

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Sub RegisterRequiresPostBack ( _
    control As Control _
)
'Usage
Dim instance As Page
Dim control As Control

instance.RegisterRequiresPostBack(control)

public void RegisterRequiresPostBack (
    Control control
)

public:
void RegisterRequiresPostBack (
    Control^ control
)

public void RegisterRequiresPostBack (
    Control control
)

public function RegisterRequiresPostBack (
    control : Control
)

Parameter

control
Das zu registrierende Steuerelement.

Ausnahmen

Ausnahmetyp	Bedingung
HttpException	Das zu registrierende Steuerelement implementiert nicht die IPostBackDataHandler-Schnittstelle.

Hinweise

Das zu registrierende Steuerelement muss die IPostBackDataHandler-Schnittstelle implementieren. Andernfalls wird eine HttpException ausgelöst. Wenn die IPostBackDataHandler-Schnittstelle von einem Steuerelement implementiert wird, aktiviert sie die Behandlung von Postbackdaten und das Auslösen von Ereignissen für geänderte Postbackdaten. Weitere Informationen über das Ereignismodell für Serversteuerelemente finden Sie unter Ereignismodell für ASP.NET-Webserversteuerelemente.

Registrieren Sie Steuerelemente für die Seite während des Page_PreRender-Ereignisses im Lebenszyklus der Seite oder vor diesem Ereignis.

Beispiel

Im folgenden Codebeispiel wird mithilfe der RegisterRequiresPostBack-Methode festgelegt, dass das Textfeld-Steuerelement myTextBox zurückgesendet werden muss, bevor dem Textfeld zugeordneter Code ausgeführt werden kann. TextBox-Steuerelemente implementieren die IPostBackDataHandler-Schnittstelle.

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

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);
}

void Text_Change(Object sender, EventArgs e)
{
  myLabel.set_Text("<b>Welcome " + myTextBox.get_Text()
      + " to ASP.NET</b>");
}

void Page_Load(Object sender, EventArgs e)
{
  this.RegisterRequiresPostBack(myTextBox);
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Page-Klasse
Page-Member
System.Web.UI-Namespace
IsPostBack
IPostBackDataHandler-Schnittstelle

Weitere Ressourcen

Übersicht über den Lebenszyklus von ASP.NET-Seiten
Ereignismodell für ASP.NET-Webserversteuerelemente

Freigeben über