Control.OnBubbleEvent(Object, EventArgs) Method

Definition

Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página.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

Parameters

source
Object

El origen del evento.The source of the event.

args
EventArgs

Objeto EventArgs que contiene los datos de evento.An EventArgs object that contains the event data.

Returns

Boolean

Es true si se ha cancelado el evento; en caso contrario, es false.true if the event has been canceled; otherwise, false. El valor predeterminado es false.The default is false.

Examples

En el ejemplo siguiente se invalida el método OnBubbleEvent en un control de servidor ASP.NET personalizado, ParentControl.The following example overrides the OnBubbleEvent method in a custom ASP.NET server control, ParentControl. Este método se invoca cuando un control secundario de ParentControl llama al método RaiseBubbleEvent.This method is invoked when a child control of ParentControl calls the RaiseBubbleEvent method. Cuando esto sucede, la clase ParentControl escribe dos cadenas en la página que contiene ASP.NET, la primera que indica que se ha llamado a su método OnBubbleEvent, la segunda que identifica el control de código fuente del método 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
 _

Remarks

Los controles de servidor ASP.NET como los controles Web Repeater, DataList y GridView pueden contener controles secundarios que generen eventos.ASP.NET server controls such as the Repeater, DataList and GridView Web controls can contain child controls that raise events. Por ejemplo, cada fila de un control de GridView puede contener uno o más botones creados dinámicamente por plantillas.For example, each row in a GridView control can contain one or more buttons created dynamically by templates. En lugar de cada botón que genera un evento de forma individual, los eventos de los controles anidados se "propagan", es decir, se envían al contenedor de nomenclatura.Rather than each button raising an event individually, events from the nested controls are "bubbled" - that is, they are sent to the naming container. A su vez, el contenedor de nomenclatura genera un evento genérico denominado RowCommand con valores de parámetro.The naming container in turn raises a generic event called RowCommand with parameter values. Estos valores le permiten determinar qué control individual ha generado el evento original.These values allow you to determine which individual control that raised the original event. Al responder a este evento único, puede evitar tener que escribir métodos de control de eventos individuales para los controles secundarios.By responding to this single event, you can avoid having to write individual event-handling methods for child controls.

Applies to

See also