Control.OnBubbleEvent(Object, EventArgs) Méthode

Définition

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.

protected:
 virtual bool OnBubbleEvent(System::Object ^ source, EventArgs ^ args);
protected virtual bool OnBubbleEvent (object source, EventArgs args);
abstract member OnBubbleEvent : obj * EventArgs -> bool
override this.OnBubbleEvent : obj * EventArgs -> bool
Protected Overridable Function OnBubbleEvent (source As Object, args As EventArgs) As Boolean

Paramètres

source
Object

Source de l'événement.

args
EventArgs

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

Retours

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.

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);
   }
}
Public Class ParentControl
   Inherits Control
   
   <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
   Protected Overrides Function OnBubbleEvent(sender As Object, e As EventArgs) As Boolean
      Context.Response.Write("<br><br>ParentControl's OnBubbleEvent called.")
      Context.Response.Write(("<br>Source of event is: " + sender.ToString()))
      Return True
   End Function 'OnBubbleEvent
   
   <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
   Protected Overrides Sub Render(myWriter As HtmlTextWriter)
      myWriter.Write("ParentControl")
      RenderChildren(myWriter)
   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 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