Utilisation des événements DataAdapter

  • Article

MsDb2DataAdapter expose deux événements que vous pouvez utiliser pour répondre aux modifications apportées aux données au niveau de la source de données. Le tableau ci-dessous répertorie les événements MsDb2DataAdapter.

Événement Description
Rowupdating Une opération UPDATE, INSERT ou DELETE sur une ligne (par un appel à l'une des méthodes Update) est sur le point de commencer.
Rowupdated Une opération UPDATE, INSERT ou DELETE sur une ligne (par un appel à l'une des méthodes Update) est terminée.

RowUpdating est déclenché avant qu’une mise à jour d’une ligne à partir du jeu de données ait été traitée au niveau de la source de données. RowUpdated est déclenché après le traitement de toute mise à jour d’une ligne à partir du jeu de données au niveau de la source de données. Par conséquent, vous pouvez utiliser RowUpdating pour modifier le comportement de mise à jour avant qu’elle ne se produise, pour fournir une gestion supplémentaire lorsqu’une mise à jour se produit, pour conserver une référence à une ligne mise à jour, pour annuler la mise à jour actuelle et planifier son traitement par lots ultérieurement, et ainsi de suite. RowUpdated est utile pour réagir aux erreurs et aux exceptions qui surviennent pendant la mise à jour. Vous pouvez ajouter des informations d’erreur, une logique de nouvelle tentative, etc. au jeu de données.

Arguments

Les MsDb2RowUpdatingEventArgs arguments et MsDb2RowUpdatedEventArgs qui sont passés aux RowUpdating événements et RowUpdated sont les suivants :

  • Propriété Command qui fait référence à l’objet Command utilisé pour effectuer la mise à jour.

  • Propriété Row qui fait référence à l’objet DataRow contenant les informations mises à jour.

  • Propriété StatementType du type de mise à jour en cours d’exécution.

  • , le TableMappingcas échéant.

  • Status de l'opération.

    Vous pouvez utiliser la Status propriété pour déterminer si une erreur s’est produite pendant l’opération et, si vous le souhaitez, pour contrôler les actions par rapport aux lignes actuelles et résultantes. Lorsque l'événement se produit, la propriété Status est égale à Continue ou ErrorsOccurred.

Valeurs de la propriété Status

Le tableau suivant montre les valeurs sur lesquelles vous pouvez définir la Status propriété afin de contrôler les actions suivantes pendant la mise à jour.

Statut Description
Continuer Continuer l'opération de mise à jour.
ErreursOccuréd Abandonner l'opération de mise à jour et lever une exception.
SkipCurrentRow Ignorer la ligne actuelle et continuer l'opération de mise à jour.
SkipAllRemainingRows Abandonnez l’opération de mise à jour, mais ne lèvez pas d’exception.

L'affectation de la valeur Status à la propriété ErrorsOccurred entraîne la levée d'une exception. Vous pouvez contrôler l'exception levée en affectant la propriété Errors à l'exception souhaitée. L'utilisation de l'une des autres valeurs pour Status évite la levée d'une exception.

Voir aussi

Utilisation de DataAdapter et de DataSet pour une base de données DB2
Utilisation du fournisseur managé pour DB2