Control.OnBubbleEvent(Object, EventArgs) Método

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.dll

Determina si el evento del control de servidor se pasa a la jerarquía de controles de servidor de interfaz de usuario de la página.

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

Parámetros

source
Object

Origen del evento.

args
EventArgs

Objeto EventArgs que contiene los datos del evento.

Devoluciones

Boolean

true si se ha cancelado el evento; de lo contrario, false. El valor predeterminado es false.

Ejemplos

En el ejemplo siguiente se invalida el método OnBubbleEvent en un control de servidor de ASP.NET personalizado, ParentControl. Este método se invoca cuando un control secundario de ParentControl llama al RaiseBubbleEvent método . Cuando esto sucede, la clase ParentControl escribe dos cadenas en la página contenedora de ASP.NET, la primera que indica que se ha llamado a su método OnBubbleEvent, el segundo que identifica el control de código fuente del método RaiseBubbleEvent.

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
 _

Comentarios

ASP.NET controles de servidor, como Repeater, DataList y GridView Controles web pueden contener controles secundarios que generan eventos. Por ejemplo, cada fila de un GridView control puede contener uno o varios botones creados dinámicamente por plantillas. En lugar de cada botón que genera un evento individualmente, los eventos de los controles anidados se "propagan", es decir, se envían al contenedor de nomenclatura. A su vez, el contenedor de nomenclatura genera un evento genérico denominado RowCommand con valores de parámetro. Estos valores permiten determinar qué control individual generó el evento original. Al responder a este único evento, puede evitar tener que escribir métodos individuales de control de eventos para controles secundarios.

Se aplica a

Consulte también