Control.RaiseBubbleEvent(Object, EventArgs) Control.RaiseBubbleEvent(Object, EventArgs) Control.RaiseBubbleEvent(Object, EventArgs) Control.RaiseBubbleEvent(Object, EventArgs) Method

Definition

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.Assigns any sources of the event and its information to the control's parent.

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

Die Quelle des Ereignisses.The source of the event.

args
EventArgs EventArgs EventArgs EventArgs

Ein EventArgs-Objekt, das die Ereignisdaten enthält.An EventArgs object that contains the event data.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine benutzerdefinierte- ChildControlKlasse erstellt wird Button.OnClick , wobei die- RaiseBubbleEvent Methode überschrieben wird Button.Click , um die-Methode aufzurufen, die das Ereignis an das übergeordnete ASP.NET-ServerThe following code example demonstrate how to create a custom class, ChildControl, overriding the Button.OnClick method to call the RaiseBubbleEvent method that sends the Button.Click event to its parent ASP.NET server control. Wenn der Benutzer auf eine Schaltfläche in einer ASP.NET-Seite klickt, die ChildControleine Instanz von enthält OnBubbleEvent , löst er die-Methode für das übergeordnete ChildControl Steuerelement aus, das die Instanz von enthält, und schreibt die Zeichenfolge "The childControl Class OnClick method is wird "auf der Seite aufgerufen.When the user clicks a button in an ASP.NET page that includes an instance of ChildControl, it raises the OnBubbleEvent method on the parent control that contains the instance of ChildControl and writes the string "The ChildControl class OnClick method is called" to the page.

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 'OnClick
End Class 'ChildControl 

Hinweise

ASP.NET-Server Steuerelemente wie Repeaterdie DataList - GridView ,-und-websteuer Elemente können untergeordnete Steuerelemente enthalten, die-EreignisseASP.NET server controls such as the Repeater, DataList and GridView Web controls can contain child controls that raise events. Jede Zeile in einem GridView -Steuerelement kann beispielsweise eine oder mehrere Schaltflächen enthalten, die dynamisch durch Vorlagen erstellt wurden.For example, each row in a GridView control can contain one or more buttons created dynamically by templates. Anstatt jede Schaltfläche einzeln ein Ereignis aufzusenden, werden Ereignisse aus den schsted-Steuerelementen "Bubbled", d. h., Sie werden an das übergeordnete Element des Steuer Elements gesendet.Rather than each button raising an event individually, events from the nested controls are "bubbled" - that is, they are sent to the control's parent. Das übergeordnete Element löst wiederum ein generisches RowCommand Ereignis namens mit Parameterwerten aus.The parent in turn raises a generic event called RowCommand with parameter values. Mit diesen Werten können Sie bestimmen, welches einzelne Steuerelement das ursprüngliche Ereignis ausgelöst hat.These values allow you to determine which individual control that raised the original event. Wenn Sie auf dieses einzelne Ereignis reagieren, können Sie vermeiden, dass Sie einzelne Ereignis Behandlungsmethoden für untergeordnete Steuerelemente schreiben müssen.By responding to this single event, you can avoid having to write individual event-handling methods for child controls.

Diese Methode kann zwar nicht außer Kraft gesetzt werden, von Ihnen Erbende Steuerelemente können aber durch über OnBubbleEvent Schreiben der-Methode Ereignisse verarbeiten oder lösen.While you cannot override this method, controls you author can handle or raise bubbled events by overriding the OnBubbleEvent method.

Gilt für:

Siehe auch