Partager via


BOF, propriétés EOF (ADO)

S’applique à : Access 2013, Office 2013

BOF — Indique que la position d'enregistrement actuelle se trouve 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 renvoyée

Les propriétés BOF et EOF retournent des valeurs de type Boolean.

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 vous déplacez d'un enregistrement à l'autre.

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

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

Si deux le BOF ou EOF propriété est vrai, il n’est aucun enregistrement actif.

Si vous ouvrez un objet Recordset qui ne contient pas d’enregistrement, les propriétés BOF et EOF ont la valeur True (reportez-vous à la propriété RecordCount pour plus d’informations sur cet état d’un objet Recordset). Lorsque vous ouvrez un objet Recordset qui contient au moins un enregistrement, le premier enregistrement correspond au dernier enregistrement et les propriétés BOF et EOF ont la valeur False.

Si vous supprimez le dernier enregistrement restant dans la jeu d’enregistrements objet, le BOF et EOF propriétés peuvent restent faux jusqu'à ce que vous tentative de repositionner l’enregistrement actif.

Ce tableau répertorie les méthodes Move autorisées avec les 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é

Erreur

Erreur

Autorisé

BOF=False,
EOF=True

Autorisé

Autorisé

Erreur

Erreur

Les deux vrai

Error

Erreur

Erreur

Error

Les deux faux

Autorisé

Autorisé

Autorisé

Autorisé

Même si une méthode Move est autorisée, rien ne garantit que la méthode parviendra à localiser 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 ci-dessous répertorie les valeurs prises par les propriétés BOF et EOF lorsque vous appelez différentes méthodes Move et que vous ne parvenez pas à trouver un enregistrement.

BOF

EOF

MoveFirst, MoveLast

Prend la valeur True

Prend la valeur True

Move 0

Aucune modification

Aucune modification

MovePrevious, Move< 0

Prend la valeur True

Aucune modification

MoveNext, Move> 0

Aucune modification

Prend la valeur True