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, |
MovePrevious, |
|
MoveNext, |
|
---|---|---|---|---|
BOF=True, |
Autorisé |
Erreur |
Erreur |
Autorisé |
BOF=False, |
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 |