Control.RaiseBubbleEvent-Methode

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

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

Syntax

'Declaration
Protected Sub RaiseBubbleEvent ( _
    source As Object, _
    args As EventArgs _
)
'Usage
Dim source As Object
Dim args As EventArgs

Me.RaiseBubbleEvent(source, args)

protected void RaiseBubbleEvent (
    Object source,
    EventArgs args
)

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

protected void RaiseBubbleEvent (
    Object source, 
    EventArgs args
)

protected function RaiseBubbleEvent (
    source : Object, 
    args : EventArgs
)

Parameter

• source
  Die Quelle des Ereignisses.

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

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 das übergeordnete Element des Steuerelements gesendet. Das übergeordnete Element wiederum löst mit Parameterwerten das generische Ereignis ItemCommand 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.

Diese Methode können Sie nicht überschreiben, aber von Ihnen erstellte Steuerelemente können Bubbled-Ereignisse durch Überschreiben der OnBubbleEvent-Methode behandeln oder auslösen.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die benutzerdefinierte Klasse ChildControlerstellt wird, indem die Button.OnClick-Methode überschrieben wird, um die RaiseBubbleEvent-Methode aufzurufen, die das Button.Click-Ereignis an das übergeordnete ASP.NET-Serversteuerelement sendet. Wenn der Benutzer auf eine Schaltfläche auf einer ASP.NET-Seite klickt, die eine Instanz von ChildControl enthält, wird dadurch die OnBubbleEvent-Methode des übergeordneten Steuerelements ausgelöst, das die Instanz von ChildControl enthält, und die Zeichenfolge "ChildControl's OnClick called" wird auf die Seite geschrieben.

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 

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 extends Button
{
    protected void OnClick(EventArgs e)
    {
        super.OnClick(e);
        get_Context().get_Response().Write("<br><br>ChildControl's OnClick"
            + " called.");
        // Bubble this event to parent.
        RaiseBubbleEvent(this, e);
    } //OnClick

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
OnBubbleEvent