Control.RaiseBubbleEvent(Object, EventArgs) Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.

protected:
 void RaiseBubbleEvent(System::Object ^ source, EventArgs ^ args);

protected void RaiseBubbleEvent (object source, EventArgs args);

member this.RaiseBubbleEvent : obj * EventArgs -> unit

Protected Sub RaiseBubbleEvent (source As Object, args As EventArgs)

Parameter

source

Object

Die Quelle des Ereignisses.

args

EventArgs

Ein EventArgs-Objekt, das die Ereignisdaten enthält.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine benutzerdefinierte Klasse erstellt wird, ChildControlund die -Methode zum Aufrufen der -Methode, die RaiseBubbleEvent das Ereignis an das Button.Click übergeordnete ASP.NET Serversteuerelement sendet, überschrieben Button.OnClick wird. Wenn der Benutzer auf eine Schaltfläche in einer ASP.NET Seite klickt, die eine instance von ChildControlenthält, löst er die OnBubbleEvent -Methode für das übergeordnete Steuerelement aus, das den instance von ChildControl enthält, und schreibt die Zeichenfolge "The ChildControl class OnClick method is called" (Die ChildControl-Klasse OnClick-Methode wird aufgerufen) auf die Seite.

public class ChildControl : Button
{
   [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
   protected override void OnClick(EventArgs e) 
   {
      base.OnClick(e);
      Context.Response.Write("<br><br>ChildControl's OnClick called.");
      // Bubble this event to parent.
      RaiseBubbleEvent(this, e);
   }

Public Class ChildControl
   Inherits Button
   
   <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
   Protected Overrides Sub OnClick(e As EventArgs)
      MyBase.OnClick(e)
      Context.Response.Write("<br><br>ChildControl's OnClick called.")
      ' Bubble this event to parent.
      RaiseBubbleEvent(Me, e)
   End Sub
End Class

Hinweise

ASP.NET Serversteuerelemente wie das Repeater- DataList und GridView das Websteuerelement können untergeordnete Steuerelemente enthalten, die Ereignisse auslösen. Beispielsweise kann jede Zeile in einem GridView Steuerelement eine oder mehrere Schaltflächen enthalten, die dynamisch von Vorlagen erstellt werden. Anstatt jede Schaltfläche, die ein Ereignis einzeln auslöst, werden Ereignisse aus den geschachtelten Steuerelementen "blasend" – das heißt, sie werden an das übergeordnete Element des Steuerelements gesendet. Das übergeordnete Ereignis wiederum löst ein generisches Ereignis namens RowCommand mit Parameterwerten aus. Mit diesen Werten können Sie bestimmen, welches einzelne Steuerelement das ursprüngliche Ereignis ausgelöst hat. Wenn Sie auf dieses einzelne Ereignis reagieren, können Sie vermeiden, dass sie einzelne Ereignisbehandlungsmethoden für untergeordnete Steuerelemente schreiben müssen.

Sie können diese Methode zwar nicht außer Kraft setzen, aber Steuerelemente, die Sie erstellen, können blasenweise Ereignisse behandeln oder auslösen, indem Sie die OnBubbleEvent -Methode überschreiben.

Weitere Informationen

• OnBubbleEvent(Object, EventArgs)