Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
Control.RaiseBubbleEvent, méthode
Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle.
Assembly : System.Web (dans System.Web.dll)
Paramètres
- source
- Type : System.Object
Source de l'événement.
- args
- Type : System.EventArgs
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 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 dynamiquement par les 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é 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.
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); }
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
