次の方法で共有


CRecordset::IsBOF

レコードセットが前に、最初のレコード設定以外の値を返します。現在のレコードがありません。

BOOL IsBOF( ) const;

戻り値

レコードセットがレコードが含まれていない場合、または以前に最初のレコード間を前後にスクロールする場合は、; それ以外の場合は 0。

解説

前に、レコードセットの最初のレコードであったかどうかについては、レコード間をスクロールする前にこのメンバー関数を呼び出します。また IsEOF とともにレコードセットがレコードを含む場合、または空であるかどうかを確認するに IsBOF を使用できます。**[開く]**を呼び出した直後に、レコードセットがレコードがある場合、IsBOF は非ゼロを返します。1 文字以上のレコードを持つレコードセットを開くと、先頭のレコードが現在のレコードと IsBOF は 0 を返します。

最初のレコードが現在のレコードで、MovePrevを呼び出すと、IsBOF に、非ゼロを返します。IsBOF がゼロ以外の値を返し、MovePrevを呼び出すと、エラーが発生します。IsBOF がゼロ以外の値を返した場合、現在のレコードは定義されず、現在のレコードを要求するアクションにエラーが発生します。

使用例

この例では、双方向のコードのレコードセット内をスクロールするレコードセットの境界を検出するために IsBOFIsEOF を使用します。

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

必要条件

Header: afxdb.h

参照

関連項目

CRecordset クラス

階層図

CRecordset::IsEOF

CRecordset::MoveFirst

CRecordset::MovePrev