Limites d’un recordset

S’applique à : Access 2013, Office 2013

Utilisez les propriétés BOF et EOF pour déterminer si un objet Recordset contient des enregistrements ou si vous avez dépassé les limites d'un objet Recordset en vous déplaçant d'un enregistrement à l'autre. Considérez les propriétés BOF et EOF comme des enregistrements « fantômes » placés au début et à la fin de l'objet Recordset. En se basant sur l’exemple d’objet Recordset présenté dans Examen des données, on obtient les résultats suivants :

La propriété BOF retourne la valeur True (-1) si la position d'enregistrement actif est située avant le premier enregistrement et la valeur False (0) si la position d'enregistrement actif est située au niveau du premier enregistrement ou après celui-ci.

La propriété EOF renvoie la valeur True si la position d'enregistrement actif est située après le dernier enregistrement et la valeur False si la position d'enregistrement actif est située au niveau du dernier enregistrement ou avant celui-ci.

Si la propriété BOF ou EOF a la valeur True, cela signifie qu'il n'y a aucun enregistrement actif, comme l'illustre le code suivant :

 
If oRs.BOF And oRs.EOF Then 
 ' Command returned no records. 
End If 

Si vous ouvrez un objet Recordset ne contenant aucun enregistrement, les propriétés BOF et EOF ont toutes deux la valeur True et la valeur définie pour la propriété RecordCount de l'objet Recordset dépend du type de curseur. -1 est retourné pour les curseurs dynamiques (CursorType = adOpenDynamic) et 0 pour les autres curseurs.

Lorsque vous ouvrez un objet Recordset qui contient au moins un enregistrement, le premier enregistrement est l'enregistrement actif. Les propriétés BOF et EOF ont, dans ce cas, la valeur False.

Si vous supprimez le dernier enregistrement restant de l'objet Recordset, le curseur reste dans un état indéterminé. Selon le fournisseur, les propriétés BOF et EOF peuvent conserver la valeur False jusqu'à ce que vous tentiez de repositionner l'enregistrement actif.