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:

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