É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.

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.

Ajouts de la communauté

Afficher: