Page.RegisterRequiresRaiseEvent(IPostBackEventHandler) Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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

public:
 virtual void RegisterRequiresRaiseEvent(System::Web::UI::IPostBackEventHandler ^ control);

public virtual void RegisterRequiresRaiseEvent (System.Web.UI.IPostBackEventHandler control);

abstract member RegisterRequiresRaiseEvent : System.Web.UI.IPostBackEventHandler -> unit
override this.RegisterRequiresRaiseEvent : System.Web.UI.IPostBackEventHandler -> unit

Public Overridable Sub RegisterRequiresRaiseEvent (control As IPostBackEventHandler)

Parameter

control

IPostBackEventHandler

Das zu registrierende Steuerelement.

Beispiele

Im folgenden Codebeispiel wird die RegisterRequiresRaiseEvent Methode zum Registrieren eines Button Webserversteuerelements verwendet, da ein Ereignis ausgelöst werden muss. Nachdem Sie das erste Button Steuerelement registriert haben, können Sie dazu führen, dass das zweite Button Steuerelement, das im Code deklariert ist, die Ergebnisse des Klickereignisses der ersten Schaltfläche auf die Seite posten.

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

    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

Hinweise

Pro Seitenanforderung kann nur ein Serversteuerelement registriert werden. Das RegisterRequiresRaiseEvent Steuerelement muss verwendet werden, wenn das Steuerelement seine Steuerelement-ID nicht in die Formularbeitragsdaten einschließt. Außerdem muss das registrierte Steuerelement die IPostBackEventHandler Schnittstelle implementieren.

Siehe auch

• IsPostBack