CDaoRecordset::IsEOF

Const BOOL IsEOF ();
throw (CDaoException, CMemoryException);

戻り値

0 以外の値をレコードセットにレコードが含まれていない場合、または最後のレコードを越えてスクロールした場合;そうでなければ 0。

解説

レコードセットの最終レコードを超えてを行っているかどうかを記録するレコードをスクロールすると、このメンバー関数を呼び出します。レコードセットにレコードが存在するかどうかを確認するには、 IsEOFを呼び出すこともできます。レコードセットにレコードが含まれていない場合、オープン、呼び出したすぐ後、 IsEOFが 0 以外の値を返します。少なくとも 1 つのレコードがレコードセットを開くときに、現在のレコードの最初のレコードであるし、 IsEOFは 0 を返します。

MoveNextを呼び出すと、最後のレコードが現在のレコード場合は、 IsEOF後 0 以外を返します。IsEOFが 0 以外の値を返す場合、 MoveNextを呼び出すと、例外がスローされます。IsEOFが 0 以外の値を返す場合は、現在のレコードが定義されていないと、現在のレコードが必要な任意のアクションは、例外が発生します。

IsBOFとIsEOFの設定の特定のメソッドの効果:

オープン呼び出し内部で最初のレコード、レコードセットの現在のレコードMoveFirstを呼び出してなります。したがって、オープン呼び出しに空のレコードセットIsBOFとIsEOFは 0 以外を返すが発生します。(失敗したMoveFirst呼び出しの動作を以下の表を参照してください)。
IsBOFとIsEOFの両方 0 を返すレコードを正常に検索すべての移動操作を引き起こす。
正常に、新しいレコードを挿入、更新呼び出しで、 AddNew呼び出しがのみIsEOFが 0 以外場合 0 を返すためには、 IsBOFが発生します。IsEOFの状態は変更されずに残ります。新しいレコードが現在のレコードの後に挿入されるように、Microsoft Jet データベースエンジンによって定義されているように、空のレコードセットの現在のレコードポインターはファイルの終わりです。
それはレコードセットから唯一の残りのレコードを削除した場合でも、 Deleteを呼び出す、 IsBOFまたはIsEOFの値変更されません。

この表示していますIsBOFの別の組み合わせで、移動操作は許可/IsEOF。

	MoveFirst、MoveLast	MovePrev, 移動 lt;0(&L)	0 を移動します。	MoveNext, 移動 gt;0(&G)
IsBOFは 0 以外、= IsEOF= 0	許可	例外	例外	許可
IsBOF= 0、 IsEOFは 0 以外 =	許可	許可	例外	例外
両方 0 以外	例外	例外	例外	例外
両方 0	許可	許可	許可	許可

移動操作が、操作が正常にレコードを検索することを意味しません。それだけしようとすると、指定した移動操作は許可され、例外は生成されませんを示します。IsBOFとIsEOFメンバー関数の移動を試行の結果として変更します。

レコードは、 IsBOFとIsEOFの設定の値が見つからない移動操作の効果を次の表に表示されます。

	IsBOF	IsEOF
MoveFirst、 MoveLast	0 以外の値	0 以外の値
0 を移動	変更なし	変更なし
MovePrev、移動lt;0(&L)	0 以外の値	変更なし
MoveNext、移動gt;0(&G)	変更なし	0 以外の値

レコードセットの移動の詳細については、資料を参照してください DAO レコードセット: レコードセットの移動でVisual の C++ プログラマのガイド。関連情報についてを参照してください「BOF、EOF プロパティ「DAO ヘルプ。

CDaoRecordset の概要|nbsp;クラスメンバー |階層図(&N)

参照特価;CDaoRecordset::IsBOF(&N)

Index