CRecordset::IsBOF

Artikel
06/10/2015

Gibt Wert ungleich 0 zurück, wenn das Recordset vor dem ersten Datensatz platziert wurde. Es gibt keinen aktuellen Datensatz.

BOOL IsBOF( ) const;

Rückgabewert

Ungleich 0 (null), wenn das Recordset keine Datensätze enthält, oder wenn Sie rückwärts vor dem ersten Datensatz hinaus gescrollt haben; 0 andernfalls.

Hinweise

Rufen Sie die Memberfunktion auf, bevor Sie von Datensatz zu Datensatz wechseln, um zu erfahren, ob Sie vor dem ersten Datensatz des Recordsets gegangen sind. Sie können IsBOF zusammen mit IsEOF auch verwenden, um zu bestimmen, ob das Recordset alle Datensätze enthält oder leer ist. Unmittelbar nach dem Sie Öffnen aufrufen, wenn das Recordset keine Datensätze enthält, gibt IsBOF-Wert ungleich 0 (null) zurück. Wenn Sie ein Recordset öffnen, das mindestens einen Datensatz ist, ist der erste Datensatz die gibt 0 des aktuellen Datensatzes und IsBOF.

Wenn der erste Datensatz der aktuelle Datensatz ist und Sie MovePrev aufrufen, gibt IsBOF nach Wert ungleich 0 (null) zurück. Wenn IsBOF-Wert ungleich 0 zurückgibt und Sie MovePrev aufrufen, tritt ein Fehler auf. Wenn IsBOF-Wert ungleich 0 zurückgibt, wird der aktuelle Datensatz nicht definiert, und jede Aktion, die einen aktuellen Datensatz erfordert, führt zu einem Fehler.

Beispiel

In diesem Beispiel wird IsBOF und IsEOF, um die Grenzen eines Recordsets zu erkennen, während der Code durch das Recordset in beide Richtungen durch.

// 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();