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

Определение

Присваивает родительскому элементу управления все источники события и сведения о них.Assigns any sources of the event and its information to the control's parent.

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

Источник события.The source of the event.

args
EventArgs

Объект EventArgs, содержащий данные о событии.An EventArgs object that contains the event data.

Примеры

В следующем примере кода показано, как создать пользовательский класс, ChildControlпереопределив метод Button.OnClick для вызова метода RaiseBubbleEvent, который отправляет событие Button.Click в родительский серверный элемент управления ASP.NET.The following code example demonstrate how to create a custom class, ChildControl, overriding the Button.OnClick method to call the RaiseBubbleEvent method that sends the Button.Click event to its parent ASP.NET server control. Когда пользователь нажимает кнопку на странице ASP.NET, которая содержит экземпляр ChildControl, он вызывает метод OnBubbleEvent в родительском элементе управления, содержащем экземпляр ChildControl, и записывает строку "метод OnClick класса Чилдконтрол вызывается на странице.When the user clicks a button in an ASP.NET page that includes an instance of ChildControl, it raises the OnBubbleEvent method on the parent control that contains the instance of ChildControl and writes the string "The ChildControl class OnClick method is called" to the page.

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, могут содержать дочерние элементы управления, которые инициируют события.ASP.NET server controls such as the Repeater, DataList and GridView Web controls can contain child controls that raise events. Например, каждая строка в элементе управления GridView может содержать одну или несколько кнопок, созданных динамически по шаблонам.For example, each row in a GridView control can contain one or more buttons created dynamically by templates. Вместо каждой кнопки, создающей событие по отдельности, события из вложенных элементов управления являются "пузырькed", то есть они отправляются в родительский элемент элемента управления.Rather than each button raising an event individually, events from the nested controls are "bubbled" - that is, they are sent to the control's parent. Родительский элемент, в свою очередь, вызывает универсальное событие с именем RowCommand со значениями параметров.The parent in turn raises a generic event called RowCommand with parameter values. Эти значения позволяют определить, какой отдельный элемент управления вызвал исходное событие.These values allow you to determine which individual control that raised the original event. Отвечая на это одно событие, можно избежать необходимости написания отдельных методов обработки событий для дочерних элементов управления.By responding to this single event, you can avoid having to write individual event-handling methods for child controls.

Хотя вы не можете переопределить этот метод, создаваемые элементы управления могут обрабатывать или создавать Пузырьковые события путем переопределения метода OnBubbleEvent.While you cannot override this method, controls you author can handle or raise bubbled events by overriding the OnBubbleEvent method.

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

Дополнительно