Page.RegisterRequiresRaiseEvent(IPostBackEventHandler) Page.RegisterRequiresRaiseEvent(IPostBackEventHandler) Page.RegisterRequiresRaiseEvent(IPostBackEventHandler) Page.RegisterRequiresRaiseEvent(IPostBackEventHandler) Method

Definition

Registriert ein ASP.NET-Serversteuerelement als Steuerelement, für das ein Ereignis ausgelöst werden muss, wenn es im Page-Objekt verarbeitet wird.Registers an ASP.NET server control as one requiring an event to be raised when the control is processed on the Page object.

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 IPostBackEventHandler IPostBackEventHandler IPostBackEventHandler

Das zu registrierende Steuerelement.The control to register.

Beispiele

Im folgenden Codebeispiel wird die RegisterRequiresRaiseEvent -Methode verwendet, Button um ein Webserver-Steuerelement so zu registrieren, dass ein Ereignis ausgelöst werden muss.The following code example uses the RegisterRequiresRaiseEvent method to register a Button Web server control as requiring an event to be raised. Nachdem Sie das erste Button Steuerelement registriert haben, können Sie bewirken, dass das zweite Button Steuerelement, das im Code deklariert wurde, die Ergebnisse des Click-Ereignisses der ersten Schaltfläche auf der Seite sendet.After you have registered the first Button control, you can cause the second Button control declared in the code to post the results of the first button's click event to the page.

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 Seiten Anforderung kann nur ein Server Steuerelement registriert werden.Only one server control can be registered per page request. Der RegisterRequiresRaiseEvent -Wert muss verwendet werden, wenn das Steuerelement seine Steuerelement-ID nicht in die Formular-Post-Daten einschließt.The RegisterRequiresRaiseEvent must be used when the control does not include its control ID in the form post data. Außerdem muss das Steuerelement, das registriert ist, IPostBackEventHandler die-Schnittstelle implementieren.Also, the control that is registered must implement the IPostBackEventHandler interface.

Gilt für:

Siehe auch