Partager via

EndOfRecordset, événement (ADO)

  • Article

L'événement EndOfRecordset est appelé en cas de tentative de déplacement vers une ligne située au-delà de la fin de l’objet Recordset.

Syntaxe

  
EndOfRecordset fMoreData, adStatus, pRecordset

Paramètres

fMoreData
Valeur VARIANT_BOOL qui, si elle est définie sur VARIANT_TRUE, indique des lignes ont été ajoutées au Recordset.

adStatus
Une valeur d’état EventStatusEnum.

Quand l’événement EndOfRecordset est appelé, ce paramètre est défini sur adStatusOK si l’opération qui a provoqué 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 qui a provoqué cet événement.

Avant que l’événement EndOfRecordset retourne un résultat, définissez ce paramètre sur adStatusUnwantedEvent pour empêcher les notifications suivantes.

pRecordset
Un objet Recordset. Le Recordset pour lequel cet événement s’est produit.

Notes

Un événement EndOfRecordset peut se produire si l’opération MoveNext échoue.

Ce gestionnaire d’événements est appelé en cas de tentative de déplacement au-delà de la fin de l’objet Recordset, peut-être suite à l’appel de l’opération MoveNext. Toutefois, pendant cet événement, vous pourriez récupérer d'autres enregistrements d'une base de données, et les ajouter à la fin de l’objet Recordset. Dans ce cas, définissez fMoreData sur VARIANT_TRUE, et retournez à partir de l’événement EndOfRecordset. Appelez ensuite l’opération MoveNext à nouveau pour accéder aux enregistrements nouvellement récupérés.

Voir aussi

Exemple de modèle d’événements ADO (VC ++)
Présentation rapide du gestionnaire d’événements ADO