Partager via


CDaoRecordset::IsEOF

Appelez la fonction membre comme vous le faites défiler de l'enregistrement à l'autre pour savoir si vous êtes disparu au delà de le dernier enregistrement du recordset.

BOOL IsEOF( ) const;

Valeur de retour

Une valeur différente de zéro si le recordset ne contient aucun enregistrement ou si vous l'avez fait défiler au delà de le dernier enregistrement ; sinon 0.

Notes

Vous pouvez également appeler IsEOF pour déterminer si le recordset contient les enregistrements ou est vide. Après l'appel Ouvrir, si le recordset ne contient aucun enregistrement, IsEOF retourne une valeur différente de zéro. Lorsque vous ouvrez un recordset qui possède au moins un enregistrement, le premier enregistrement est retourne 0 d'enregistrement actif et d' IsEOF .

Si le dernier enregistrement constitue l'enregistrement courant lorsque vous appelez MoveNext, IsEOF retourne ensuite une valeur différente de zéro. Si IsEOF retourne une valeur différente de zéro et vous appelez MoveNext, une exception est levée. Si IsEOF retourne une valeur différente de zéro, l'enregistrement en cours est pas défini, et toute action qui requiert un enregistrement actif entraîne une exception.

Effet des méthodes spécifiques sur IsBOF et des paramètres d' IsEOF :

  • Appelant Ouvrir note en interne au premier enregistrement du recordset l'enregistrement courant en appelant MoveFirst. Par conséquent, l'appel Ouvrir sur un ensemble vide d'enregistrements pour retourner IsBOF et IsEOF une valeur différente de zéro. (Consultez le tableau suivant pour le comportement d'un appel de MoveFirst .)

  • Tous passent des opérations qui localisez avec succès une cause d'enregistrement IsBOF et IsEOF pour retourner 0.

  • Un appel d' AddNew suivi d'un appel de Mettre à jour qui insère correctement un nouvel enregistrement fait retourner IsBOF 0, mais uniquement si IsEOF est déjà différent de zéro. L'état d' IsEOF reste toujours inchangé. Comme défini par le moteur de base de données Microsoft Jet, le pointeur d'enregistrement actif d'un recordset est vide à la fin d'un fichier, donc tout nouvel enregistrement est inséré après l'enregistrement courant.

  • Aucun appel de Supprimer , même s'il supprime le seul enregistrement restant du recordset, ne modifie la valeur d' IsBOF ou d' IsEOF.

Ce tableau affiche les opérations de mouvements sont autorisées avec différentes combinaisons d' IsBOF/IsEOF.

 

MoveFirst, MoveLast

MovePrev,

Déplacement < 0

Déplacement 0

MoveNext,

Déplacement > 0

=nonzero d'IsBOF,

IsEOF=0

Autorisé

Exception

Exception

Autorisé

IsBOF=0,

=nonzero d'IsEOF

Autorisé

Autorisé

Exception

Exception

Les deux une valeur différente de zéro

Exception

Exception

Exception

Exception

Les deux 0

Autorisé

Autorisé

Autorisé

Autorisé

Permettre une opération de déplacement ne signifie pas que l'opération définira correctement un enregistrement. Il indique simplement qu'une tentative d'exécuter l'opération spécifiée de déplacement est autorisée et ne génère pas d'exception. La valeur des fonctions membres d' IsBOF et d' IsEOF peut changer suite à le déplacement tentée.

L'effet des opérations de déplacement qui ne localisez pas un enregistrement de la valeur d' IsBOF et des paramètres d' IsEOF indiqué dans le tableau suivant.

 

IsBOF

IsEOF

MoveFirst, MoveLast

Une valeur différente de zéro

Une valeur différente de zéro

Déplacer 0

Aucune modification

Aucune modification

MovePrev, Déplacer < 0

Une valeur différente de zéro

Aucune modification

MoveNext, Déplacer > 0

Aucune modification

Une valeur différente de zéro

Pour des informations connexes, consultez la rubrique « BOF, les propriétés d'EOF » dans l'aide de DAO.

Configuration requise

Header: afxdao.h

Voir aussi

Référence

CDaoRecordset, classe

Graphique de la hiérarchie

CDaoRecordset::IsBOF