Control.RaiseBubbleEvent(Object, EventArgs) Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle.

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)

Paramètres

source

Object

Source de l'événement.

args

EventArgs

Objet EventArgs qui contient les données d’événement.

Exemples

L’exemple de code suivant montre comment créer une classe personnalisée, ChildControl, en substituant la Button.OnClick méthode pour appeler la RaiseBubbleEvent méthode qui envoie l’événement Button.Click à son contrôle serveur parent ASP.NET. Lorsque l’utilisateur clique sur un bouton dans une page de ASP.NET qui comprend une instance de ChildControl, il déclenche la OnBubbleEvent méthode sur le contrôle parent qui contient le instance de et écrit la chaîne « La méthode OnClick de ChildControl la classe ChildControl est appelée » dans la 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

Remarques

ASP.NET contrôles serveur tels que les RepeaterDataList contrôles web et GridView peuvent contenir des contrôles enfants qui déclenchent des événements. Par exemple, chaque ligne d’un GridView contrôle peut contenir un ou plusieurs boutons créés dynamiquement par des modèles. Au lieu que chaque bouton déclenche un événement individuellement, les événements des contrôles imbriqués sont « en bulles », c’est-à-dire qu’ils sont envoyés au parent du contrôle. Le parent déclenche à son tour un événement générique appelé RowCommand avec des valeurs de paramètre. Ces valeurs vous permettent de déterminer quel contrôle individuel a déclenché l’événement d’origine. En répondant à cet événement unique, vous pouvez éviter d’avoir à écrire des méthodes de gestion des événements individuelles pour les contrôles enfants.

Bien que vous ne puissiez pas remplacer cette méthode, les contrôles que vous créez peuvent gérer ou déclencher des événements en bulles en remplaçant la OnBubbleEvent méthode.

Voir aussi

• OnBubbleEvent(Object, EventArgs)