CRecordset::IsBOF

發行項
02/28/2013

如果資料錄集的位置後，在第一個資料錄之前，傳回非零。沒有目前資料錄。

BOOL IsBOF( ) const;

傳回值

不是零，如果資料錄集不包含資料錄，或如果反向移動，在第一個資料錄之前，則為 0。

備註

呼叫此成員函式，從資料錄捲動至資料錄學習之前，移至您是否在資料錄集的第一個資料錄之前。您可以使用 IsEOF 一起使用 IsBOF 判斷資料錄集是否包含任何資料錄或是空的。在呼叫後，開啟，如果資料錄集並不包含資料錄， IsBOF 傳回非零。當您開啟至少有一個資料錄的資料錄集時，第一筆資料錄保留為目前資料錄和 IsBOF 會傳回 0。

如果第一筆資料錄保留為目前資料錄，並呼叫 MovePrev， IsBOF 接下來將傳回非零。如果 IsBOF 傳回非零，而且您 MovePrev呼叫，則會發生錯誤。如果 IsBOF 傳回非零，目前的資料錄，則會發生未定義，而且需要一個目前記錄的所有動作會導致錯誤。

範例

這個範例會使用 IsBOF 和 IsEOF 偵測資料錄集的限制為程式碼捲動雙向的資料錄集。

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