Control.OnBubbleEvent(Object, EventArgs) Control.OnBubbleEvent(Object, EventArgs) Control.OnBubbleEvent(Object, EventArgs) Control.OnBubbleEvent(Object, EventArgs) Method

Определение

Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

protected:
 virtual bool OnBubbleEvent(System::Object ^ source, EventArgs ^ args);
protected virtual bool OnBubbleEvent (object source, EventArgs args);
abstract member OnBubbleEvent : obj * EventArgs -> bool
override this.OnBubbleEvent : obj * EventArgs -> bool
Protected Overridable Function OnBubbleEvent (source As Object, args As EventArgs) As Boolean

Параметры

source
Object Object Object Object

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

args
EventArgs EventArgs EventArgs EventArgs

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

Возвраты

Значение true, если событие было отменено, в противном случае — значение false.true if the event has been canceled; otherwise, false. Значение по умолчанию — false.The default is false.

Примеры

В следующем примере переопределяется OnBubbleEvent метод в пользовательском серверном ParentControlэлементе управления ASP.NET.The following example overrides the OnBubbleEvent method in a custom ASP.NET server control, ParentControl. Этот метод вызывается, когда дочерний элемент ParentControl управления RaiseBubbleEvent вызывает метод.This method is invoked when a child control of ParentControl calls the RaiseBubbleEvent method. В этом ParentControl случае класс записывает две строки на страницу, содержащую ASP.NET, первый из OnBubbleEvent которых сообщает о вызове метода, второй определяет систему управления RaiseBubbleEvent версиями метода.When this happens, the ParentControl class writes two strings to the containing ASP.NET page, the first stating that its OnBubbleEvent method has been called, the second identifying the source control of the RaiseBubbleEvent method.

public class ParentControl : Control 
{
   [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
   protected override bool OnBubbleEvent(object sender, EventArgs e)
   {
      Context.Response.Write("<br><br>ParentControl's OnBubbleEvent called.");
      Context.Response.Write("<br>Source of event is: " + sender.ToString());
      return true;
   }
   [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
   protected override void Render( HtmlTextWriter myWriter)
   {
      myWriter.Write("ParentControl");
      RenderChildren(myWriter);
   }
}
Public Class ParentControl
   Inherits Control
   
   <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
   Protected Overrides Function OnBubbleEvent(sender As Object, e As EventArgs) As Boolean
      Context.Response.Write("<br><br>ParentControl's OnBubbleEvent called.")
      Context.Response.Write(("<br>Source of event is: " + sender.ToString()))
      Return True
   End Function 'OnBubbleEvent
   
   <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
   Protected Overrides Sub Render(myWriter As HtmlTextWriter)
      myWriter.Write("ParentControl")
      RenderChildren(myWriter)
   End Sub
End Class 'ParentControl
 _

Комментарии

Серверные элементы управления ASP.NET Repeater, такие как, и GridView веб-элементы управления, DataList могут содержать дочерние элементы управления, которые инициируют события.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 naming container. Контейнер именования, в свою очередь, вызывает универсальное событие, вызываемое RowCommand со значениями параметров.The naming container 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.

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

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