BOF, EOF, propriétés (ADO)
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 à
Voir aussi
BOF, EOF et Bookmark, exemple de propriétés (VB)
Exemple de propriétés BOF, EOF et Bookmark (VC++)