Événement EndOfRecordset (ADO)
S’applique à : Access 2013, Office 2013
L’événement EndOfRecordset est appelé lors d’une tentative de positionnement sur une ligne au-delà de la fin d’un objet Recordset.
Syntaxe
EndOfRecordsetfMoreData, adStatus, pRecordset
Paramètres
| Paramètre | Description |
|---|---|
| fMoreData | Valeur de type VARIANT_BOOL. Si elle correspond à VARIANT_TRUE (condition vraie), indique que des lignes ont été ajoutées au Recordset. |
| adStatus |
EventStatusEnum. Lorsque EndOfRecordset est appelé, ce paramètre est défini sur adStatusOK si l’opération à l’origine de l’événement a réussi. Il est défini sur adStatusCantDeny si cet événement ne peut pas demander l’annulation de l’opération à l’origine de cet événement. Avant que EndOfRecordset ne soit retourné, affectez la valeur adStatusUnwantedEvent à ce paramètre afin d'empêcher toute notification ultérieure. |
| pRecordset | A Recordset object. The Recordset for which this event occurred. |
Remarques
Un événement EndOfRecordset peut être généré si l'opération MoveNext échoue.
Ce gestionnaire d'événements est appelé lors d'une tentative de positionnement au-delà de la fin de l'objet Recordset, résultant probablement d'un appel à MoveNext. À partir de l'événement, il est toujours possible toutefois de récupérer plusieurs enregistrements d'une base de données et de les ajouter à la fin de l'objet Recordset. Si c'est le cas, définissez fMoreData à VARIANT_TRUE et quittez l'événement EndOfRecordset. Rappelez ensuite MoveNext pour accéder aux nouveaux enregistrements récupérés.