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

Definition

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

protected:
 virtual bool OnBubbleEvent(System::Object ^ source, EventArgs ^ args);
protected virtual bool OnBubbleEvent (object source, EventArgs args);
abstract member OnBubbleEvent : obj * EventArgs -> bool
override this.OnBubbleEvent : obj * EventArgs -> bool
Protected Overridable Function OnBubbleEvent (source As Object, args As EventArgs) As Boolean

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.

Gibt zurück

true, wenn das Ereignis abgebrochen wurde, andernfalls false.true if the event has been canceled; otherwise, false. Die Standardeinstellung ist false.The default is false.

Beispiele

Im folgenden Beispiel wird die OnBubbleEvent -Methode in einem benutzerdefinierten ASP.NET-Server Steuerelement,, ParentControlüberschrieben.The following example overrides the OnBubbleEvent method in a custom ASP.NET server control, ParentControl. Diese Methode wird aufgerufen, wenn ein untergeordnetes ParentControl Steuerelement RaiseBubbleEvent von die-Methode aufruft.This method is invoked when a child control of ParentControl calls the RaiseBubbleEvent method. Wenn dies der Fall ist ParentControl , schreibt die-Klasse zwei Zeichen folgen in die enthaltende ASP.NET-Seite OnBubbleEvent , die erste, die angibt, dass Ihre-Methode aufgerufen wurde RaiseBubbleEvent , die zweite, die die Quell Code Verwaltung der Methode identifiziert.When this happens, the ParentControl class writes two strings to the containing ASP.NET page, the first stating that its OnBubbleEvent method has been called, the second identifying the source control of the RaiseBubbleEvent method.

public class ParentControl : Control 
{
   [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
   protected override bool OnBubbleEvent(object sender, EventArgs e)
   {
      Context.Response.Write("<br><br>ParentControl's OnBubbleEvent called.");
      Context.Response.Write("<br>Source of event is: " + sender.ToString());
      return true;
   }
   [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
   protected override void Render( HtmlTextWriter myWriter)
   {
      myWriter.Write("ParentControl");
      RenderChildren(myWriter);
   }
}
Public Class ParentControl
   Inherits Control
   
   <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
   Protected Overrides Function OnBubbleEvent(sender As Object, e As EventArgs) As Boolean
      Context.Response.Write("<br><br>ParentControl's OnBubbleEvent called.")
      Context.Response.Write(("<br>Source of event is: " + sender.ToString()))
      Return True
   End Function 'OnBubbleEvent
   
   <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
   Protected Overrides Sub Render(myWriter As HtmlTextWriter)
      myWriter.Write("ParentControl")
      RenderChildren(myWriter)
   End Sub
End Class
 _

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 den Benennungs Container gesendet.Rather than each button raising an event individually, events from the nested controls are "bubbled" - that is, they are sent to the naming container. Der Benennungs Container löst wiederum ein generisches Ereignis RowCommand namens mit Parameterwerten aus.The naming container 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.

Gilt für:

Siehe auch