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

Definizione

Assegna eventuali origini dell'evento e relative informazioni al controllo padre.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)

Parametri

source
Object Object Object Object

Origine dell'evento.The source of the event.

args
EventArgs EventArgs EventArgs EventArgs

Oggetto EventArgs che contiene i dati dell'evento.An EventArgs object that contains the event data.

Esempi

Nell'esempio di codice seguente viene illustrato come creare una classe personalizzata ChildControl,, eseguendo l' Button.OnClick override del metodo per RaiseBubbleEvent chiamare il metodo che Button.Click invia l'evento al controllo server ASP.NET padre.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. Quando l'utente fa clic su un pulsante in una pagina ASP.NET che include un' ChildControlistanza di, genera OnBubbleEvent il metodo sul controllo padre che contiene l'istanza di ChildControl e scrive la stringa "il metodo OnClick della classe ChildControl è chiamato "alla pagina.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

Commenti

I controlli server ASP.NET, ad Repeateresempio DataList , GridView e i controlli Web possono contenere controlli figlio che generano eventi.ASP.NET server controls such as the Repeater, DataList and GridView Web controls can contain child controls that raise events. Ogni riga di un GridView controllo, ad esempio, può contenere uno o più pulsanti creati dinamicamente da modelli.For example, each row in a GridView control can contain one or more buttons created dynamically by templates. Anziché ogni pulsante che genera un evento singolarmente, gli eventi dei controlli nidificati vengono "bollati", ovvero vengono inviati all'elemento padre del controllo.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. L'elemento padre genera a sua volta un evento RowCommand generico chiamato con i valori dei parametri.The parent in turn raises a generic event called RowCommand with parameter values. Questi valori consentono di determinare il singolo controllo che ha generato l'evento originale.These values allow you to determine which individual control that raised the original event. Rispondendo a questo singolo evento, è possibile evitare di dover scrivere singoli metodi di gestione degli eventi per i controlli figlio.By responding to this single event, you can avoid having to write individual event-handling methods for child controls.

Sebbene non sia possibile eseguire l'override di questo metodo, i controlli creati possono gestire o generare eventi Bubble eseguendo OnBubbleEvent l'override del metodo.While you cannot override this method, controls you author can handle or raise bubbled events by overriding the OnBubbleEvent method.

Si applica a

Vedi anche