BOF, EOF, propriétés (ADO)

  • Article

  • La propriété BOF indique que la position de l’enregistrement actif dans un objet Recordset est avant le premier enregistrement.

  • La propriété EOF indique que la position de l’enregistrement actif dans un objet Recordset est après le dernier enregistrement.

Valeur renvoyée

Les propriétés BOF et EOF retournent des valeurs booléennes.

Notes

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 lorsque vous passez d’un enregistrement à l’autre.

La propriété BOF retourne True (-1) si la position de l’enregistrement actif est avant le premier enregistrement, et False (0) si la position de l’enregistrement actif est sur ou après le premier enregistrement.

La propriété EOF retourne True si la position de l’enregistrement actif est après le dernier enregistrement, et False si la position de l’enregistrement actif est sur ou avant le dernier enregistrement.

Si la propriété BOF ou EOF a la valeur True, cela signifie qu’il n’existe pas d’enregistrement actif.

Si vous ouvrez un objet Recordset ne contenant pas d’enregistrement, les propriétés BOF et EOF sont définies sur True (pour plus d’informations sur cet état d’un objet Recordset, voir la propriété RecordCount). Lorsque vous ouvrez un objet Recordset contenant au moins un enregistrement, le premier enregistrement est l’enregistrement actif et les propriétés BOF et EOF sont définies sur False.

Si vous supprimez le dernier enregistrement restant dans l’objet Recordset, les propriétés BOF et EOF peuvent rester définies sur False jusqu’à ce que vous tentiez de repositionner l’enregistrement actif.

Ce tableau montre quelles méthodes Move sont autorisées avec différentes combinaisons des propriétés BOF et EOF.

MoveFirst,

MoveLast		 MovePrevious,

Move < 0		 Move 0 MoveNext,

Move > 0
BOF=True, EOF=False Autorisé Error Error Autorisé
BOF=False, EOF=True Autorisé Autorisé Error Error
Tous deux True Error Error Error Error
Tous deux False Autorisé Autorisé Autorisé Autorisé

L’autorisation d’une méthode Move ne garantit pas que la méthode localisera correctement un enregistrement, mais signifie uniquement que l’appel de la méthode Move spécifiée ne générera pas d’erreur.

Le tableau suivant montre ce qu’il advient des paramètres de propriété BOF et EOF lorsque vous appelez diverses méthodes Move, mais ne parvenez pas à localiser un enregistrement.

BOF EOF
MoveFirst, MoveLast Définir sur True Définir sur True
Move 0 Aucun changement Aucun changement
MovePrevious, Move< 0 Définir sur True Aucun changement
MoveNext, Move> 0 Aucun changement Définir sur True

S'applique à

Recordset, objet (ADO)

Voir aussi

BOF, EOF et Bookmark, exemple de propriétés (VB)
Exemple de propriétés BOF, EOF et Bookmark (VC++)