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ímu 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 , ChildControlpřepsání Button.OnClick metody volání RaiseBubbleEvent metody, která odesílá Button.Click událost do nadřazeného ASP.NET serverového ovládacího prvku. Když uživatel klikne na tlačítko v ASP.NET stránce, která obsahuje instanci ChildControl, vyvolá metodu OnBubbleEvent nadřazeného ovládacího prvku, který obsahuje instanci ChildControl a zapíše řetězec "The ChildControl třídy OnClick metoda 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 serverové ovládací prvky, jako Repeaterjsou ovládací prvky , DataList a GridView Web, můžou obsahovat podřízené ovládací prvky, které vyvolávají události. Například každý řádek GridView ovládacího prvku může obsahovat jedno nebo více tlačítek vytvořených dynamicky pomocí šablon. Místo toho, aby každé tlačítko vyvolalo událost jednotlivě, jsou události z vnořených ovládacích prvků "bublinové" – to znamená, že se odesílají do nadřazené položky ovládacího prvku. Nadřazený objekt zase vyvolá obecnou událost s názvem RowCommand s hodnotami parametrů. Tyto hodnoty umožňují určit, který jednotlivý ovládací prvek vyvolal původní událost. Když odpovíte na tuto jednu událost, můžete se vyhnout nutnosti psát jednotlivé metody zpracování událostí pro podřízené ovládací prvky.

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

Viz také

• OnBubbleEvent(Object, EventArgs)