Exporter (0) Imprimer
Développer tout

Control.RaiseBubbleEvent, méthode

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

Espace de noms : System.Web.UI
Assembly : System.Web (dans system.web.dll)

protected void RaiseBubbleEvent (
	Object source,
	EventArgs args
)
protected void RaiseBubbleEvent (
	Object source, 
	EventArgs args
)
protected function RaiseBubbleEvent (
	source : Object, 
	args : EventArgs
)

Paramètres

source

Source de l'événement.

args

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

Les contrôles serveur ASP.NET, tels que les contrôles Web Repeater, DataList et DataGrid, peuvent contenir des contrôles enfants qui déclenchent des événements. Par exemple, chaque ligne d'un contrôle DataGrid 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 parent du contrôle). À son tour, le parent déclenche un événement générique appelé ItemCommand 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.

Même si vous ne pouvez pas substituer cette méthode, les contrôles que vous créez peuvent gérer ou déclencher des événements propagés en substituant la méthode OnBubbleEvent.

L'exemple de code suivant montre comment créer une classe personnalisée, ChildControl, qui substitue la méthode Button.OnClick pour appeler la méthode RaiseBubbleEvent qui envoie l'événement Button.Click à son contrôle serveur ASP.NET parent. Lorsque l'utilisateur clique sur un bouton dans une page ASP.NET comprenant une instance de ChildControl, la méthode OnBubbleEvent est appelée sur le contrôle parent qui contient l'instance de ChildControl et la chaîne "The ChildControl class OnClick method is called" (La méthode OnClick de la classe ChildControl est appelée) est écrite 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 extends Button
{
    protected void OnClick(EventArgs e)
    {
        super.OnClick(e);
        get_Context().get_Response().Write("<br><br>ChildControl's OnClick"
            + " called.");
        // Bubble this event to parent.
        RaiseBubbleEvent(this, e);
    } //OnClick

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

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft