Page.RegisterRequiresRaiseEvent-Methode

Registriert ein ASP.NET-Serversteuerelement als Steuerelement, für das ein Ereignis ausgelöst werden muss, wenn es im Page-Objekt verarbeitet wird.

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

Syntax

'Declaration
Public Overridable Sub RegisterRequiresRaiseEvent ( _
    control As IPostBackEventHandler _
)
'Usage
Dim instance As Page
Dim control As IPostBackEventHandler

instance.RegisterRequiresRaiseEvent(control)

public virtual void RegisterRequiresRaiseEvent (
    IPostBackEventHandler control
)

public:
virtual void RegisterRequiresRaiseEvent (
    IPostBackEventHandler^ control
)

public void RegisterRequiresRaiseEvent (
    IPostBackEventHandler control
)

public function RegisterRequiresRaiseEvent (
    control : IPostBackEventHandler
)

Parameter

• control
  Das zu registrierende Steuerelement.

Hinweise

Pro Seitenanforderung kann nur ein Serversteuerelement registriert werden. Wenn die Daten des bereitgestellten Formulars nicht die Steuerelement-ID des Steuerelements enthalten, muss RegisterRequiresRaiseEvent verwendet werden. Außerdem muss das registrierte Steuerelement die IPostBackEventHandler-Schnittstelle implementieren.

Beispiel

Im folgenden Codebeispiel wird die RegisterRequiresRaiseEvent-Methode verwendet, um ein Button-Webserversteuerelement als Steuerelement zu registrieren, für das ein Ereignis ausgelöst werden muss. Nachdem Sie das erste Button-Steuerelement registriert haben, können Sie festlegen, dass das zweite im Code deklarierte Button-Steuerelement die Ergebnisse des Click-Ereignisses der ersten Schaltfläche für die Seite bereitstellt.

  Sub DisplayUserName(Sender As Object, e As EventArgs) 
     Response.Write("Welcome to " + Server.HtmlEncode(userName.Text))
  End Sub

 Sub MyRaiseEvent(Sender As Object, e As EventArgs)
     'Raises a post back event for a control.
      Me.RaisePostBackEvent(userButton, "")
 End Sub 
  
  Sub Page_Load(Sender As Object, e As EventArgs)
    
    'Registers a control as one that requires postback handling
    Me.RegisterRequiresRaiseEvent(userButton)
End Sub

void DisplayUserName(Object sender, EventArgs ea) 
{
   Response.Write("Welcome to " + Server.HtmlEncode(userName.Text));
}
void RaiseEvent(Object sender, EventArgs ea)
{
   // Raise a post back event for a control.
   this.RaisePostBackEvent(userButton, "");
}
void Page_Load(Object sender, EventArgs ea)
{
   // Register a control as one that requires postback handling.
   this.RegisterRequiresRaiseEvent(userButton);
}

void DisplayUserName(Object sender, EventArgs ea) 
{
    get_Response().Write("Welcome to " 
        + get_Server().HtmlEncode(userName.get_Text()));
} //DisplayUserName
      
void RaiseEvent(Object sender, EventArgs ea)
{
    // Raise a post back event for a control.
    this.RaisePostBackEvent(userButton, "");
} //RaiseEvent
      
void Page_Load(Object sender, EventArgs ea)
{
    // Register a control as one that requires postback handling.
    this.RegisterRequiresRaiseEvent(userButton);
} //Page_Load    

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