CRecordset::IsBOF

Article
06/10/2015

Retourne une valeur différente de zéro si le recordset a été positionné avant le premier enregistrement. Il n'existe aucun enregistrement courant.

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

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. Vous pouvez également utiliser 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 erreur se produit. 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 provoquera une erreur.

Exemple

Cet exemple utilise IsBOF et IsEOF pour détecter les limites d'un recordset comme fait de code via le recordset dans les deux sens.

// Open a recordset; first record is current
CCustomer rsCustSet(&m_dbCust);
rsCustSet.Open();

if(rsCustSet.IsBOF())
   return;
   // The recordset is empty 

// Scroll to the end of the recordset, past 
// the last record, so no record is current 
while (!rsCustSet.IsEOF())
   rsCustSet.MoveNext();

// Move to the last record
rsCustSet.MoveLast();

// Scroll to beginning of the recordset, before 
// the first record, so no record is current 
while(!rsCustSet.IsBOF())
   rsCustSet.MovePrev();

// First record is current again
rsCustSet.MoveFirst();