CDaoRecordset::IsBOF
Appelez la fonction membre avant que vous n'accédez à l'enregistrement à l'autre pour savoir si vous êtes disparu avant que le premier enregistrement du recordset.
BOOL IsBOF( ) const;
Valeur de retour
Une valeur différente de zéro si le recordset ne contient aucun enregistrement ou si vous avez l'objet d'un défilement arrière avant que le premier enregistrement ; sinon 0.
Notes
Vous pouvez également appeler IsBOF avec 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, IsBOF 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' IsBOF .
Si le premier enregistrement constitue l'enregistrement courant et vous appelez MovePrev, IsBOF retourne ensuite une valeur différente de zéro.Si IsBOF retourne une valeur différente de zéro et vous appelez MovePrev, une exception est levée.Si IsBOF 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 de MoveFirst ou d'un appel d' MoveLast .)
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