FormView.OnBubbleEvent(Object, EventArgs) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Gère un événement transmis via la hiérarchie de contrôle.
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.
Retours
true pour indiquer que l’événement doit être transmis plus loin dans la hiérarchie de contrôle ; sinon, false.
Remarques
La Control.OnBubbleEvent méthode est utilisée par le contrôle pour gérer éventuellement les événements transmis par 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 transmettre l’événement plus loin dans la hiérarchie de contrôle par le biais de 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’un des boutons reconnus par le contrôle est cliqué. Le tableau suivant répertorie les boutons de commande que le FormView contrôle reconnaît.
| Bouton | Valeur CommandName | Description |
|---|---|---|
| Annuler | « Annuler » | Utilisé dans la mise à jour ou l’insertion d’opérations pour annuler l’opération et ignorer les valeurs entrées par l’utilisateur. Le FormView contrôle retourne ensuite au mode spécifié par la DefaultMode propriété. |
| Supprimer | « Supprimer » | Utilisé dans les opérations de suppression pour supprimer l’enregistrement affiché de la source de données. Déclenche les événements et ItemDeleted les ItemDeleting événements. |
| 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 événements et ItemInserted les ItemInserting événements. |
| Nouveau | « Nouveau » | Utilisé dans les opérations d’insertion pour placer le FormView contrôle en mode d’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 événements et PageIndexChanged les PageIndexChanging événements.
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 événements et ItemUpdated les ItemUpdating événements. |
Cette version de la méthode retourne true quand l’un de ces boutons est géré. Pour plus d’informations sur les bulles d’événements, consultez Gestion et déclenchement d’événements.
Notes pour les héritiers
Lors de l’extension de 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 transmis plus loin dans la hiérarchie de contrôle.