Événements du contrôle serveur Web GridView
Mise à jour : novembre 2007
Le contrôle GridView déclenche, au cours de la mise en page et de la mise à jour de ses données liées, plusieurs événements auxquels votre code peut répondre.
Événements GridView
Le contrôle GridView expose des événements de pagination et de tri, ainsi que des événements qui se produisent lorsque la ligne actuelle est créée ou liée à des données. Des événements sont également déclenchés lorsqu'un utilisateur clique sur un contrôle de commande, tel qu'un contrôle Button intégré au contrôle GridView. Le tableau suivant décrit les événements exposés par le contrôle GridView.
RowCommand
Se produit lors d'un clic sur le bouton d'un contrôle GridView. Cet événement est souvent utilisé pour exécuter une tâche lorsqu'un clic est effectué dans le contrôle.PageIndexChanging
Se produit lorsqu'un clic est effectué sur le bouton du pagineur, mais avant que le contrôle GridView n'effectue l'opération de pagination. Cet événement est souvent géré pour annuler l'opération de pagination.PageIndexChanged
Se produit lorsqu'un clic est effectué sur le bouton du pagineur, mais après que le contrôle GridView n'effectue l'opération de pagination. Cet événement est couramment géré lorsque vous devez exécuter une tâche après que l'utilisateur a navigué vers une page différente du contrôle.SelectedIndexChanging
Se produit lorsqu'un clic est effectué sur le bouton Select d'une ligne (bouton dont la propriété CommandName a la valeur "Select") dans un contrôle GridView, mais avant que le contrôle GridView n'exécute l'opération de sélection. Cet événement est souvent géré pour annuler l'opération de sélection.SelectedIndexChanged
Se produit lorsqu'un clic est effectué sur le bouton Select d'une ligne dans un contrôle GridView, mais après que le contrôle GridView a exécuté l'opération de sélection. Cet événement est souvent géré pour exécuter une tâche une fois qu'une ligne a été sélectionnée dans le contrôle.Sorting
Se produit lorsqu'un utilisateur clique sur le lien hypertexte permettant de trier une colonne, mais avant que le contrôle GridView n'exécute l'opération de tri. Cet événement est souvent géré pour annuler l'opération de tri ou exécuter une routine de tri personnalisée.Sorted
Se produit lorsqu'un utilisateur clique sur le lien hypertexte permettant de trier une colonne, mais après que le contrôle GridView a exécuté l'opération de tri. Cet événement est couramment géré pour exécuter une tâche une fois que l'utilisateur a cliqué sur un lien hypertexte pour trier une colonne.RowDataBound
Se produit lorsqu'une ligne du contrôle GridView est liée à un enregistrement de données. Cet événement est souvent géré pour modifier le contenu d'une ligne lorsque celle-ci est liée à des données.RowCreated
Se produit lorsqu'une ligne est créée dans le contrôle GridView. Cet événement est souvent géré pour modifier la disposition ou l'aspect d'une ligne lors de sa création.RowDeleting
Se produit lorsqu'un clic est effectué sur le bouton Delete d'une ligne (bouton dont la propriété CommandName a la valeur "Delete") dans un contrôle GridView, mais avant que le contrôle GridView ne supprime l'enregistrement de la source de données. Cet événement est souvent géré pour annuler l'opération de suppression.RowDeleted
Se produit lorsqu'un clic est effectué sur le bouton Delete d'une ligne se trouve dans un contrôle GridView, mais après que le contrôle GridView a supprimé l'enregistrement de la source de données. Cet événement est souvent géré pour vérifier les résultats de l'opération de suppression.RowEditing
Se produit lorsqu'un clic est effectué sur le bouton Edit d'une ligne (bouton dont la propriété CommandName a la valeur "Edit") dans un contrôle GridView, mais avant que le contrôle GridView ne passe en mode édition. Cet événement est souvent géré pour annuler l'opération d'édition.RowCancelingEdit
Se produit lorsqu'un clic est effectué sur le bouton Cancel d'une ligne (bouton dont la propriété CommandName a la valeur "Cancel") dans un contrôle GridView, mais avant que le contrôle GridView ne quitte le mode édition. Cet événement est souvent géré pour arrêter l'opération d'annulation.RowUpdating
Se produit lorsqu'un clic est effectué sur le bouton Update d'une ligne (bouton dont la propriété CommandName a la valeur "Update") dans un contrôle GridView, mais avant que le contrôle GridView ne mette à jour l'enregistrement. Cet événement est souvent géré pour annuler l'opération de mise à jour.RowUpdated
Se produit lorsqu'un clic est effectué sur le bouton Update d'une ligne dans un contrôle GridView, mais après que le contrôle GridView a mis à jour l'enregistrement. Cet événement est souvent géré pour vérifier les résultats de l'opération de mise à jour.DataBound
Cet événement est hérité du contrôle BaseDataBoundControl et se produit une fois que le contrôle GridView a terminé la liaison à la source de données.