FormView.OnBubbleEvent(Object, EventArgs) Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Gère un événement remonté dans la hiérarchie des contrôles.

protected:
 override bool OnBubbleEvent(System::Object ^ source, EventArgs ^ e);
protected override bool OnBubbleEvent (object source, EventArgs e);
override this.OnBubbleEvent : obj * EventArgs -> bool
Protected Overrides Function OnBubbleEvent (source As Object, e As EventArgs) As Boolean

Paramètres

source
Object

Source de l'événement.

e
EventArgs

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

Retours

Boolean

true pour indiquer que l'événement doit être remonté plus haut dans la hiérarchie des contrôles ; sinon, false.

Remarques

La Control.OnBubbleEvent méthode est utilisée par le contrôle pour gérer éventuellement les événements transmis à travers la hiérarchie de contrôle par la RaiseBubbleEvent méthode . Il détermine s’il faut gérer un événement en examinant les propriétés de l’objet EventArgs contenu dans le e paramètre . Lorsqu’un événement doit être géré, la méthode effectue l’action appropriée. D’autres événements sont ignorés et transmis à la hiérarchie de contrôle. Cette méthode indique s’il faut passer l’événement plus haut dans la hiérarchie de contrôle via sa valeur de retour.

Le FormView contrôle remplace l’implémentation de base de cette méthode pour effectuer l’action appropriée lorsque l’utilisateur clique sur l’un des boutons reconnus par le contrôle. Le tableau suivant répertorie les boutons de commande que le FormView contrôle reconnaît.

Bouton Valeur CommandName Description
Annuler « Annuler » Utilisé lors de la mise à jour ou de l’insertion d’opérations pour annuler l’opération et pour ignorer les valeurs entrées par l’utilisateur. Le FormView contrôle retourne ensuite au mode spécifié par la DefaultMode propriété .
Supprimer "Delete" Utilisé dans les opérations de suppression pour supprimer l’enregistrement affiché de la source de données. Déclenche les ItemDeleting événements et ItemDeleted .
Modifier « Modifier » Utilisé dans les opérations de mise à jour pour placer le FormView contrôle en mode édition. Le contenu spécifié dans la EditItemTemplate propriété s’affiche pour la ligne de données.
Insérer « Insérer » Utilisé dans les opérations d’insertion pour tenter d’insérer un nouvel enregistrement dans la source de données avec les valeurs fournies par l’utilisateur. Déclenche les ItemInserting événements et ItemInserted .
Nouveau « Nouveau » Utilisé dans les opérations d’insertion pour placer le FormView contrôle en mode Insertion. Le contenu spécifié dans la InsertItemTemplate propriété s’affiche pour la ligne de données.
Page « Page » Utilisé dans les opérations de pagination pour représenter un bouton dans la ligne du pagineur qui effectue la pagination. Pour spécifier l’opération de pagination, définissez la CommandArgument propriété du bouton sur « Suivant », « Prev », « First », « Last » ou l’index de la page vers laquelle naviguer. Déclenche les PageIndexChanging événements et PageIndexChanged . Note: Ce type de bouton est généralement utilisé uniquement dans le modèle de pagineur.
Update « Mettre à jour » Utilisé dans les opérations de mise à jour pour tenter de mettre à jour l’enregistrement affiché dans la source de données avec les valeurs fournies par l’utilisateur. Déclenche les ItemUpdating événements et ItemUpdated .

Cette version de la méthode retourne true quand l’un de ces boutons est géré. Pour plus d’informations sur le bouillonnement d’événements, consultez Gestion et déclenchement d’événements.

Notes pour les héritiers

Lorsque vous étendez la FormView classe, vous pouvez remplacer cette méthode pour gérer vos propres événements. Veillez à utiliser la valeur de retour pour indiquer si l’événement doit être passé plus haut dans la hiérarchie de contrôle.

S’applique à

Voir aussi