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

Определение

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

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 и записывает строку "метод OnClick класса чилдконтрол вызывается на странице.

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 элементе управления может содержать одну или несколько кнопок, созданных динамически по шаблонам. Вместо каждой кнопки, создающей событие по отдельности, события из вложенных элементов управления являются "пузырькed", то есть они отправляются в родительский элемент элемента управления. Родительский элемент, в свою очередь, вызывает универсальное событие, вызываемое RowCommand со значениями параметров. Эти значения позволяют определить, какой отдельный элемент управления вызвал исходное событие. Отвечая на это одно событие, можно избежать необходимости написания отдельных методов обработки событий для дочерних элементов управления.

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

Применяется к

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