Control.OnBubbleEvent-Methode

Bestimmt, ob das Ereignis für das Serversteuerelement in der Serversteuerelementhierarchie der Benutzeroberfläche der Seite nach oben weitergegeben wird.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Overridable Function OnBubbleEvent ( _
    source As Object, _
    args As EventArgs _
) As Boolean
'Usage
Dim source As Object
Dim args As EventArgs
Dim returnValue As Boolean

returnValue = Me.OnBubbleEvent(source, args)

protected virtual bool OnBubbleEvent (
    Object source,
    EventArgs args
)

protected:
virtual bool OnBubbleEvent (
    Object^ source, 
    EventArgs^ args
)

protected boolean OnBubbleEvent (
    Object source, 
    EventArgs args
)

protected function OnBubbleEvent (
    source : Object, 
    args : EventArgs
) : boolean

Parameter

• source
  Die Quelle des Ereignisses.

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

Rückgabewert

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

Hinweise

ASP.NET-Serversteuerelemente wie die Websteuerelemente Repeater, DataList und DataGrid können untergeordnete Steuerelemente enthalten, die Ereignisse auslösen. Jede Zeile in einem DataGrid-Steuerelement kann z. B. eine oder mehrere Schaltflächen enthalten, die mithilfe von Vorlagen dynamisch erstellt werden. Die einzelnen Schaltflächen lösen Ereignisse nicht individuell aus, stattdessen wird für die Ereignisse aus den geschachtelten Steuerelementen ein Bubble erstellt, d. h., sie werden an den Benennungscontainer gesendet. Der Benennungscontainer wiederum löst mit Parameterwerten das generische ItemCommand-Ereignis aus. Mit diesen Werten kann das jeweilige Steuerelement bestimmt werden, das das ursprüngliche Ereignis ausgelöst hat. Indem Sie auf dieses einzelne Ereignis reagieren, müssen Sie für untergeordnete Steuerelemente keine einzelnen Ereignisbehandlungsmethoden schreiben.

Beispiel

Im folgenden Beispiel wird die OnBubbleEvent-Methode im benutzerdefinierten ASP.NET-Serversteuerelement ParentControl überschrieben. Diese Methode wird aufgerufen, wenn ein untergeordnetes Steuerelement von ParentControl die RaiseBubbleEvent-Methode aufruft. Ist dies der Fall, schreibt die ParentControl-Klasse zwei Zeichenfolgen auf die enthaltende ASP.NET-Seite. Die erste besagt, dass deren OnBubbleEvent-Methode aufgerufen wurde, die zweite bezeichnet das Ausgangssteuerelement der RaiseBubbleEvent-Methode.

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 'Render
End Class 'ParentControl
 _

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 extends Control
{     
    protected boolean OnBubbleEvent(Object sender, EventArgs e) 
    {
        get_Context().get_Response().Write("<br><br>ParentControl's"
            + " OnBubbleEvent called.");
        get_Context().get_Response().Write(("<br>Source of event is: "
            + sender.ToString()));
        return true ;
    } //OnBubbleEvent      
    protected void Render(HtmlTextWriter myWriter) 
    {
        myWriter.Write("ParentControl");
        RenderChildren(myWriter);
    } //Render
} //ParentControl

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Web.UI-Namespace
RaiseBubbleEvent