Control.RaiseBubbleEvent(Object, EventArgs) Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Присваивает родительскому элементу управления все источники события и сведения о них.

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)

Параметры

source

Object

Источник события.

args

EventArgs

Объект EventArgs, содержащий данные о событии.

Примеры

В следующем примере кода показано, как создать пользовательский класс , ChildControlпереопределяющий Button.OnClick метод для вызова RaiseBubbleEvent метода, который отправляет Button.Click событие в родительский ASP.NET серверного элемента управления. Когда пользователь нажимает кнопку на странице ASP.NET, содержащей экземпляр ChildControl, он вызывает OnBubbleEvent метод в родительском элементе управления, который содержит экземпляр ChildControl , и записывает на страницу строку The ChildControl class OnClick method is called.

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

Комментарии

ASP.NET серверные элементы управления, такие как Repeater, DataList и GridView веб-элементы управления, могут содержать дочерние элементы управления, которые вызывают события. Например, каждая строка в элементе GridView управления может содержать одну или несколько кнопок, создаваемых динамически с помощью шаблонов. Вместо каждой кнопки, вызывающей событие по отдельности, события из вложенных элементов управления "пузырьковые", то есть отправляются в родительский элемент управления. Родительский объект, в свою очередь, вызывает универсальное событие RowCommand со значениями параметров. Эти значения позволяют определить, какой отдельный элемент управления вызвал исходное событие. Отвечая на это одно событие, можно избежать необходимости писать отдельные методы обработки событий для дочерних элементов управления.

Хотя вы не можете переопределить этот метод, элементы управления, которые вы создаете OnBubbleEvent , могут обрабатывать или вызывать пузырьковые события, переопределяя метод .

См. также раздел

• OnBubbleEvent(Object, EventArgs)