Recordset.EOF, propriété (DAO)

S’applique à : Access 2013, Office 2013

Renvoie une valeur qui indique si la position d'enregistrement actuelle suit le dernier enregistrement d'un objet Recordset. Boolean (en lecture seule).

Syntaxe

expression .EOF

expression Variable représentant un objet Recordset.

Remarques

Vous pouvez utiliser la BOF et EOF propriétés pour déterminer si un jeu d’enregistrements objet contient des enregistrements ou que vous avez dépassé au-delà des limites d’un Jeu d’enregistrements lorsque vous déplacez à partir d’un enregistrement à l’objet.

Détermine l’emplacement du pointeur d’enregistrement actuel le BOF et EOF retournent des valeurs.

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

Si vous ouvrez un objet Recordset qui ne contient aucun enregistrement, les propriétés BOF et EOF ont la valeur True et le paramètre de la propriété RecordCount de l'objet Recordset est égal à 0. 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 ont la valeur False; elles conservent la valeur False jusqu'à ce que vous dépassiez la limite (début ou fin) de l'objet Recordset à l'aide des méthodes MovePrevious ou MoveNext. Lorsque vous dépassez le début ou la fin de l'objet Recordset, aucun enregistrement n'existe ou n'est actif.

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.

Si vous utilisez la méthode MoveLast sur un objet Recordset contenant des enregistrements, le dernier enregistrement devient l’enregistrement actif ; si vous utilisez ensuite la méthode MoveNext , l’enregistrement actif devient non valide et la propriété EOF est définie sur True. À l’inverse, si vous utilisez la méthode MoveFirst sur un objet Recordset contenant des enregistrements, le premier enregistrement devient l’enregistrement actif ; si vous utilisez ensuite la méthode MovePrevious , il n’y a pas d’enregistrement actif et la propriété BOF est définie sur True.

En règle générale, lorsque vous travaillez avec tous les enregistrements dans une jeu d’enregistrements objet, votre code sera parcourir les enregistrements à l’aide de la MoveNext méthode jusqu'à ce que le EOF propriété est définie pour vrai.

Si vous utilisez le MoveNext méthode lors de la EOF propriété est définie sur vrai ou le MovePrevious méthode lors de la BOF propriété est définie sur vrai, une erreur se produit.

Le tableau suivant répertorie les méthodes Move sont autorisés avec différentes combinaisons de la BOF et EOF propriétés.

	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é

Si vous autorisez une méthode Move, cela ne signifie pas forcément qu'elle retrouvera un enregistrement. Cela indique simplement qu'une tentative d'exécution de la méthode Move est autorisée et ne génère aucune erreur. L'état des propriétés BOF et EOF peut changer suite à la méthode Move exécutée.

Une méthode OpenRecordset appelle en interne une méthode MoveFirst. Par conséquent, l'exécution d'une méthode OpenRecordset sur un jeu d'enregistrements vide affecte aux propriétés BOF et EOF la valeur True. (Consultez le tableau suivant pour en savoir plus sur le comportement d'une méthode MoveFirst qui a échoué.)

Toutes les méthodes Move qui parviennent à localiser un enregistrement affectent aux propriétés BOF et EOF la valeur False.

Dans un espace de travail Microsoft Access, si vous ajoutez un enregistrement à un vide jeu d’enregistrements, BOF deviendra faux, mais EOF restent True, indiquant que la position actuelle est à la fin de jeu d’enregistrements.

N’importe quel supprimer méthode, même si elle supprime du seul enregistrement restant à partir d’un jeu d’enregistrements, ne modifiez le paramètre de la BOF ou EOF propriété.

Le tableau suivant montre comment déplacer des méthodes qui ne localiser un enregistrement affectent la BOF et EOF paramètres de propriété.

	BOF	EOF
MoveFirst, MoveLast	True	True
Move	Aucune modification	Aucune modification
MovePrevious, Move< 0	True	Aucune modification
MoveNext, Move> 0	Aucune modification	True