Teilen über


Control.OnBubbleEvent(Object, EventArgs) Methode

Definition

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.

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

Die Quelle des Ereignisses.

args
EventArgs

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

Gibt zurück

true, wenn das Ereignis abgebrochen wurde, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Beispiel wird die OnBubbleEvent -Methode in einem benutzerdefinierten ASP.NET Serversteuerelement außer Kraft gesetzt. ParentControl Diese Methode wird aufgerufen, wenn ein untergeordnetes Steuerelement von ParentControl die RaiseBubbleEvent -Methode aufruft. In diesem Fall schreibt die ParentControl Klasse zwei Zeichenfolgen in die seite, die ASP.NET enthält. Die erste gibt an, dass die OnBubbleEvent -Methode aufgerufen wurde, die zweite, die die Quellcodeverwaltung der RaiseBubbleEvent -Methode identifiziert.

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 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" – d. h. sie werden an den Namenscontainer gesendet. Der Namenscontainer löst wiederum ein generisches Ereignis mit dem Namen 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.

Gilt für:

Weitere Informationen