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:

Appel ouvert à l'interne rend le premier enregistrement dans le jeu d'enregistrements l'enregistrement en cours en appelant MoveFirst. Donc, l'appel ouvert sur un ensemble vide des dossiers provoque IsBOF et IsEOF retournent zéro. (Voir le tableau suivant pour le comportement d'un appel manqué de MoveFirst .)
Toutes les opérations de déménagement avec succès localiser un enregistrement causent IsBOF et IsEOF retourner 0.
Un appel de AddNew , suivi d'un appel de mise à jour avec succès insère un nouvel enregistrement provoquera IsBOF retourner 0, mais seulement si IsEOF est déjà différent de zéro. L'état de IsEOF restera toujours inchangée. Tel que défini par le moteur de base de données Microsoft Jet, le pointeur d'enregistrement actif d'un objet recordset vide est à la fin d'un fichier, pour tout nouvel enregistrement est inséré après l'enregistrement en cours.
Tout appel à Supprimer , même si elle supprime la seule trace restante d'un objet recordset, changera pas la valeur des 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