Control.RaiseBubbleEvent(Object, EventArgs) Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Přiřadí všechny zdroje události a její informace nadřazené ovládacího prvku.

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)

Parametry

source

Object

Zdroj události

args

EventArgs

Objekt EventArgs , který obsahuje data události.

Příklady

Následující příklad kódu ukazuje, jak vytvořit vlastní třídu, ChildControl přepsání Button.OnClick metodu volání RaiseBubbleEvent metoda, která odešle událost Button.Click do nadřazeného ovládacího prvku serveru ASP.NET. Když uživatel klikne na tlačítko na stránce ASP.NET, která obsahuje instanci ChildControl, vyvolá metodu OnBubbleEvent nadřazeného ovládacího prvku, který obsahuje instanci ChildControl a zapíše řetězec "Metoda ChildControl OnClick je volána" na stránku.

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

Poznámky

ASP.NET ovládací prvky serveru, jako jsou například ovládací prvky Repeater, DataList a GridView webové ovládací prvky mohou obsahovat podřízené ovládací prvky, které vyvolávají události. Každý řádek v ovládacím GridView prvku může například obsahovat jedno nebo více tlačítek vytvořených dynamicky pomocí šablon. Místo jednotlivých tlačítek, které vyvolává událost jednotlivě, jsou události z vnořených ovládacích prvků "bublinové" – to znamená, že se odesílají do nadřazeného prvku ovládacího prvku. Nadřazený objekt zase vyvolá obecnou událost volanou RowCommand s hodnotami parametrů. Tyto hodnoty umožňují určit, který jednotlivý ovládací prvek vyvolal původní událost. Reagováním na tuto jednu událost se můžete vyhnout zápisu jednotlivých metod zpracování událostí pro podřízené ovládací prvky.

I když tuto metodu nemůžete přepsat, ovládací prvky, které autor umí zpracovat nebo vyvolat bublinové události přepsáním OnBubbleEvent metody.

Viz také

• OnBubbleEvent(Object, EventArgs)