Metodo Control.RaiseBubbleEvent (System.Web.UI)

I controlli server ASP.NET come i controlli Web Repeater, DataList e GridView possono contenere controlli figlio che generano eventi. Ciascuna riga in un controllo GridView può ad esempio contenere uno o più pulsanti creati dinamicamente dai modelli. Piuttosto che avere una situazione in cui ciascun pulsante genera un singolo evento, in questo caso gli eventi dei controlli annidati sono inviati al controllo padre. Il controllo padre a sua volta genera un evento generico denominato RowCommand con valori di parametro. Questi valori consentono di determinare il singolo controllo che ha generato l'evento originario. Rispondendo al singolo evento, è possibile evitare la creazione di singoli metodi per la gestione degli eventi dei controlli figlio.

Anche se non è possibile eseguire l'override di questo metodo, mediante i controlli modificati è possibile gestire o generare eventi propagati tramite l'override del metodo OnBubbleEvent.

Nell'esempio di codice riportato di seguito viene illustrato come creare una classe personalizzata, ChildControl, eseguendo l'override del metodo Button.OnClick per chiamare il metodo RaiseBubbleEvent che invia l'evento Button.Click al proprio controllo server ASP.NET padre. Quando l'utente seleziona un pulsante in una pagina ASP.NET che include un'istanza di ChildControl, genera il metodo OnBubbleEvent nel controllo padre che contiene l'istanza di ChildControl e scrive la stringa "The ChildControl class OnClick method is called" nella pagina.

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 

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);
   }

.NET Framework

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

Riferimenti