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

Definición

Asigna los orígenes del evento y su información al control principal del control.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)

Parámetros

source
Object Object Object Object

Origen del evento.The source of the event.

args
EventArgs EventArgs EventArgs EventArgs

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una clase personalizada, ChildControl, reemplazo la Button.OnClick método para llamar a la RaiseBubbleEvent método que envía el Button.Click eventos a su elemento primario de control de servidor 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. Cuando el usuario hace clic en un botón en una página ASP.NET que incluye una instancia de ChildControl, genera el OnBubbleEvent método en el control primario que contiene la instancia de ChildControl y escribe la cadena "The ChildControl class OnClick es el método se llama"a la página.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 'OnClick
End Class 'ChildControl 

Comentarios

Controles de servidor ASP.NET como el Repeater, DataList y GridView controles Web pueden contener los controles secundarios que provocan 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 GridView control puede contener uno o varios botones creados dinámicamente mediante 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 provoque un evento individualmente, los eventos de los controles anidados hacen una "burbuja", es decir, se envían al elemento primario del control.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. El elemento primario a la vez lanza un evento genérico denominado RowCommand con valores de parámetro.The parent in turn raises a generic event called RowCommand with parameter values. Estos valores permiten determinar qué control individual que provocó el evento original.These values allow you to determine which individual control that raised the original event. Al responder a un único evento, 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.

Mientras no se puede invalidar este método, crea los controles pueden controlar o provocar eventos traspasados invalidando el OnBubbleEvent método.While you cannot override this method, controls you author can handle or raise bubbled events by overriding the OnBubbleEvent method.

Se aplica a

Consulte también: