Control.OnBubbleEvent, méthode

Les contrôles serveur ASP.NET, tels que les contrôles Web Repeater, DataList et GridView, peuvent contenir des contrôles enfants qui déclenchent des événements. Par exemple, chaque ligne d'un contrôle GridView peut contenir un ou plusieurs boutons créés de manière dynamique par des modèles. Chaque bouton ne déclenche pas individuellement un événement. En effet, les événements des contrôles imbriqués sont « propagés » (c'est-à-dire qu'ils sont envoyés au conteneur d'attribution de noms). À son tour, le conteneur d'attribution de noms déclenche un événement générique appelé RowCommand possédant des valeurs de paramètre. Ces valeurs vous permettent de déterminer le contrôle qui a déclenché l'événement d'origine. Si vous répondez à cet événement, vous n'êtes pas obligé d'écrire des méthodes individuelles de gestion d'événements pour les contrôles enfants.

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

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 extends Control
{     
    protected boolean OnBubbleEvent(Object sender, EventArgs e) 
    {
        get_Context().get_Response().Write("<br><br>ParentControl's"
            + " OnBubbleEvent called.");
        get_Context().get_Response().Write(("<br>Source of event is: "
            + sender.ToString()));
        return true ;
    } //OnBubbleEvent      
    protected void Render(HtmlTextWriter myWriter) 
    {
        myWriter.Write("ParentControl");
        RenderChildren(myWriter);
    } //Render
} //ParentControl

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Référence