Partager via


BOF, EOF Properties (ADO)

  • BOF Indique que la position d’enregistrement actuelle est avant le premier enregistrement d’un objet Recordset .

  • EOF Indique que la position d’enregistrement actuelle se trouve après le dernier enregistrement d’un objet Recordset .

Valeur de retour

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

Remarques

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 de l’enregistrement à l’enregistrement.

La propriété BOF retourne True (-1) si la position d’enregistrement actuelle est avant le premier enregistrement et False (0) si la position d’enregistrement actuelle est activée ou après le premier enregistrement.

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

Si la propriété BOF ou EOF a la valeur True, il n’existe aucun enregistrement actif.

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

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

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

MoveFirst,

MoveLast
MovePrevious,

Déplacer < 0
Déplacer 0 MoveNext,

Déplacer > 0
BOF=True, EOF=False Autorisé Erreur Erreur Autorisé
BOF=False, EOF=True Autorisé Autorisé Erreur Erreur
True Erreur Erreur Erreur Erreur
Les deux false Autorisé Autorisé Autorisé Autorisé

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

Le tableau suivant montre ce qui se passe dans les paramètres de propriété BOF et EOF lorsque vous appelez différentes méthodes Move , mais que vous ne parvenez pas à localiser un enregistrement.

BOF EOF
MoveFirst, MoveLast Définir sur True Définir sur True
Déplacer 0 Aucune modification Aucune modification
MovePrevious, Move< 0 Définir sur True Aucune modification
MoveNext, Move> 0 Aucune modification Définir sur True

S’applique à

objet Recordset (ADO)

Voir aussi

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