Control.OnBubbleEvent(Object, EventArgs) Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page.

C#

protected virtual bool OnBubbleEvent(object source, EventArgs args);

Paramètres

source

Object

Source de l'événement.

args

EventArgs

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

Retours

Boolean

true si l'événement a été annulé ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple suivant remplace la OnBubbleEvent méthode dans un contrôle serveur de ASP.NET personnalisé, ParentControl. Cette méthode est appelée lorsqu’un contrôle enfant de ParentControl appelle la RaiseBubbleEvent méthode. Dans ce cas, la ParentControl classe écrit deux chaînes dans la page contenant ASP.NET, la première indiquant que sa OnBubbleEvent méthode a été appelée, la seconde identifiant le contrôle de code source de la RaiseBubbleEvent méthode.

C#

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

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 conteneur de noms. Le conteneur de noms 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.

S’applique à

Voir aussi

• RaiseBubbleEvent(Object, EventArgs)