CDaoRecordset::IsEOF

BOOL IsEOF (const;)
jeter (CDaoException, CMemoryException);

Valeur de retour

Différent de zéro si le jeu d'enregistrements ne contient aucun enregistrement ou si vous avez défilée au-delà du dernier enregistrement ; sinon 0.

Remarques

Appelez cette fonction membre comme vous accédez de Notice à Notice pour savoir si vous êtes passé au-delà du dernier enregistrement de l'objet recordset. Vous pouvez également appeler IsEOF pour déterminer si le jeu d'enregistrements contient tous les enregistrements ou est vide. Immédiatement après que vous appelez ouvert, si le jeu d'enregistrements ne contient aucun enregistrement, IsEOF retourne zéro. Lorsque vous ouvrez un objet recordset qui a au moins un enregistrement, le premier enregistrement est l'enregistrement en cours et IsEOF retourne 0.

Si le dernier enregistrement est l'enregistrement en cours lorsque vous appelez MoveNext, IsEOF sera par la suite retour différent de zéro. Si IsEOF retourne zéro et que vous appelez MoveNext, une exception est levée. Si IsEOF retourne zéro, l'enregistrement en cours n'est pas défini, et toute action qui requiert un enregistrement en cours entraînera une exception.

Effet de méthodes spécifiques sur les paramètres IsBOF et IsEOF:

Le tableau suivant présente les opérations de déménagement sont autorisées avec différentes combinaisons de IsBOFetIsEOF.

MoveFirst, MoveLast MovePrev,

Déménagement < ; 0

Se déplacer à 0

MoveNext,

&Gt de passage ; 0

IsBOF= zéro,
IsEOF= 0
Permis Exception Exception Permis
IsBOF= 0,
IsEOF= zéro
Permis Permis Exception Exception
Les deux différents de zéro Exception Exception Exception Exception
Les deux 0 Permis Permis Permis Permis

Permettant une opération de déplacement ne signifie pas que l'opération sera localiser correctement un dossier. Il indique simplement que tenter d'effectuer l'opération de déplacement spécifiée est autorisée et ne génère pas une exception. La valeur des fonctions membres IsBOF et IsEOF peut changer à la suite de la tentative déménagement.

Dans le tableau suivant montre l'effet des opérations de déménagement qui ne pas localiser un enregistrement sur la valeur des paramètres IsBOF et IsEOF.

IsBOF IsEOF
MoveFirst, MoveLast Différent de zéro Différent de zéro
Déplacer 0 Pas de changement Pas de changement
MovePrev, dép&lacer lt ; 0 Différent de zéro Pas de changement
MoveNext, > se déplacer ; 0 Pas de changement Différent de zéro

Pour plus d'informations sur la navigation dans les Jeux d'enregistrements, consultez l'article jeu d'enregistrements DAO : Navigation de jeu d'enregistrements dans le Guide du programmeur Visual C++. Pour plus d'informations, consultez la rubrique « BOF, propriétés d'expressions du folklore "dans l'aide de DAO.

Aperçu de CDaoRecordset |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CDaoRecordset::IsBOF

Index