Control.RaiseBubbleEvent(Object, EventArgs) Methode

Definitie

Naamruimte:
System.Web.UI
Assembly:
System.Web.dll

Wijst alle bronnen van de gebeurtenis en de bijbehorende informatie toe aan het bovenliggende besturingselement.

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)

Parameters

source
Object

De bron van de gebeurtenis.

args
EventArgs

Een EventArgs object dat de gebeurtenisgegevens bevat.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een aangepaste klasse, ChildControl, de methode Button.OnClick overschrijft om de methode RaiseBubbleEvent aan te roepen waarmee de gebeurtenis Button.Click wordt verzonden naar het bovenliggende ASP.NET serverbeheer. Wanneer de gebruiker op een knop klikt op een ASP.NET pagina met een exemplaar van ChildControl, wordt de methode OnBubbleEvent op het bovenliggende besturingselement met het exemplaar van ChildControl weergegeven en wordt de tekenreeks 'De methode ChildControl class OnClick wordt aangeroepen' naar de pagina geschreven.

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
End Class

Opmerkingen

ASP.NET serverbesturingselementen zoals de Repeater, DataList en GridView Webbesturingselementen kunnen onderliggende besturingselementen bevatten die gebeurtenissen veroorzaken. Elke rij in een GridView besturingselement kan bijvoorbeeld een of meer knoppen bevatten die dynamisch door sjablonen zijn gemaakt. In plaats van elke knop die een gebeurtenis afzonderlijk aangeeft, worden gebeurtenissen van de geneste besturingselementen 'bellen' genoemd. Dat wil gezegd, ze worden verzonden naar het bovenliggende besturingselement. Het bovenliggende item genereert op zijn beurt een algemene gebeurtenis die wordt aangeroepen RowCommand met parameterwaarden. Met deze waarden kunt u bepalen welk afzonderlijk besturingselement de oorspronkelijke gebeurtenis heeft gegenereerd. Door op deze ene gebeurtenis te reageren, kunt u voorkomen dat u afzonderlijke methoden voor het afhandelen van gebeurtenissen hoeft te schrijven voor onderliggende besturingselementen.

Hoewel u deze methode niet kunt overschrijven, kunt u besturingselementen die u ontwerpt, gebeurtenissen met bellen verwerken of genereren door de OnBubbleEvent methode te overschrijven.

Van toepassing op

Zie ook