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