Événements ADO WillMove et MoveComplete
❮ Référence complète de l'objet Recordset
L'événement WillMove
L'événement WillMove est déclenché avant qu'une opération modifie la position actuelle dans le jeu d'enregistrements.
Remarque : Avant le retour de cet événement, définissez le paramètre d'état sur adStatusCancel pour annuler l'opération à l'origine de cet événement ou définissez-le sur adStatusUnwantedEvent pour empêcher les notifications ultérieures.
L'événement MoveComplete
L'événement MoveComplete est déclenché après la modification de la position actuelle dans le jeu d'enregistrements.
Remarque : Avant le retour de cet événement, définissez le paramètre d'état sur adStatusUnwantedEvent pour empêcher les notifications ultérieures.
Remarque : L'événement WillMove ou l'événement MoveComplete peut se produire lors de l'appel de l'une des méthodes Recordset suivantes : Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew et Requery. Ces événements peuvent également se produire en raison des propriétés suivantes : Filter, Index, Bookmark, AbsolutePage et AbsolutePosition.
Syntaxe
WillMove reason,status,objRs
MoveComplete reason,objErr,status,objRs
| Parameter | Description |
|---|---|
| reason | An EventReasonEnum value that specifies the reason for this event |
| status | An EventStatusEnum value that indicates the status of the execution of the event |
| objErr | The name of an Error object that describes the error if status is set to adStatusErrorsOccurred, otherwise it is not set |
| objRs | The name of the Recordset object that triggered this event |
Valeurs EventReasonEnum
| Constant | Value | Description |
|---|---|---|
| adRsnRequery | 7 | An operation requeried the Recordset |
| adRsnMove | 10 | An operation moved the record pointer within the Recordset |
| adRsnMoveFirst | 12 | An operation moved the record pointer to the first record in the Recordset |
| adRsnMoveNext | 13 | An operation moved the record pointer to the next record in the Recordset |
| adRsnMovePrevious | 14 | An operation moved the record pointer to the previous record in the Recordset |
| adRsnMoveLast | 15 | An operation moved the record pointer to the last record in the Recordset |
Valeurs EventStatusEnum
| Constant | Value | Description |
|---|---|---|
| adStatusOK | 1 | The operation that caused the event was successful |
| adStatusErrorsOccurred | 2 | The operation that caused the event failed |
| adStatusCantDeny | 3 | The operation that caused the event cannot be cancelled |
| adStatusCancel | 4 | The operation that caused the event is cancelled |
| adStatusUnwantedEvent | 5 | Prevents subsequent notifications before the event method has finished executing |
❮ Référence complète de l'objet Recordset