Data.Win.ADODB.TEventStatus
Delphi
TEventStatus = (esOK, esErrorsOccured, esCantDeny, esCancel, esUnwantedEvent);
C++
enum DECLSPEC_DENUM TEventStatus : unsigned char { esOK, esErrorsOccured, esCantDeny, esCancel, esUnwantedEvent };
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
enum | public | Data.Win.ADODB.pas Data.Win.ADODB.hpp |
Data.Win.ADODB | Data.Win.ADODB |
Description
Les valeurs TEventStatus indiquent le succès ou l'échec d'une opération.
Lisez les valeurs TEventStatus pour déterminer l'état de réussite ou d'échec d'une opération qui a déclenché un événement. Une valeur TEventStatus est transmise au gestionnaire de chaque événement des descendants de TADOConnection et TCustomADODataSet. Chaque valeur TEventStatus est l'équivalent direct des valeurs ADO portant le même nom.
Il est possible, dans certains cas, d'affecter une valeur au paramètre d'état du gestionnaire afin de modifier le résultat de la situation qui a déclenché l'événement. Ces situations sont décrites dans les rubriques d'aide des événements concernés des composants connexion et ensemble de données.
Le paramètre EventStatus des gestionnaires d'événements associés reproduit le paramètre adStatus ADO (de type ADO EventStatusEnum) de ces événements. Si l'opération a été exécutée sans problème, la valeur renvoyée par TEventStatus est esOK. Si l'exécution a rencontré un problème, l'une des autres valeurs est renvoyée. Par exemple, esErrorsOccured est renvoyée si l'opération a échoué à cause d'une ou de plusieurs conditions d'erreur.
TEventStatus est constitué de cinq constantes décrites dans le tableau suivant :
Option d'exécution | Signification |
---|---|
esOK |
L'opération s'est exécutée sans problème. |
esErrorsOccured |
Une erreur s'est produite lors de l'exécution de l'opération. |
esCantDeny |
Une opération de connexion en attente n'a pu être annulée. (Evénements de connexion uniquement). |
esCancel |
Une connexion en attente a été annulée avant de devenir active. (Evénements de connexion uniquement). |
esUnwantedEvent |
Défini par la méthode ADO, empêche les notifications ultérieures de l'événement. |