CDaoRecordset::IsBOF

BOOL IsBOF (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 le défilement vers l'arrière avant le premier enregistrement ; sinon 0.

Remarques

Appelez cette fonction membre avant vous accédez de Notice à Notice pour savoir si vous êtes passé avant le premier enregistrement de l'objet recordset. Vous pouvez également appeler IsBOF et 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, IsBOF retourne zéro. Lorsque vous ouvrez un objet recordset qui a au moins un enregistrement, le premier enregistrement est l'enregistrement en cours et IsBOF retourne 0.

Si le premier enregistrement est l'enregistrement en cours et que vous appelez MovePrev, IsBOF sera par la suite retour différent de zéro. Si IsBOF retourne zéro et que vous appelez MovePrev, une exception est levée. Si IsBOF 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 échec appel MoveFirst ou MoveLast .)
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::IsEOF

Index