BOF、EOF プロパティ (ADO)

  • BOF は、現在のレコード位置が Recordset オブジェクトの最初のレコードの前にあることを示します。

  • EOF は、現在のレコード位置が Recordset オブジェクトの最後のレコードの後にあることを示します。

戻り値

BOF および EOF プロパティはブール値を返します。

注釈

BOF および EOF プロパティを使用して、Recordset オブジェクトにレコードが含まれているかどうか、またはレコード間を移動するときに Recordset オブジェクトの制限を超えたかどうかを判別します。

BOF プロパティは、現在のレコード位置が最初のレコードの前にある場合は True (-1) を返し、現在のレコードの位置が最初のレコードと同じまたはそれより後にある場合は False (0) を返します。

EOF プロパティは、現在のレコード位置が最後のレコードの後にある場合は True を返し、現在のレコードの位置が最後のレコードと同じまたはそれより前にある場合は False を返します。

BOF または EOF プロパティのいずれかが True の場合、現在のレコードはありません。

レコードが含まれない Recordset オブジェクトを開くと、BOF および EOF プロパティは True に設定されます (この状態の Recordset について詳しくは、RecordCount プロパティを参照してください)。 1 つ以上のレコードを含む Recordset オブジェクトを開くと、最初のレコードが現在のレコードになり、BOF および EOF プロパティは False になります。

Recordset オブジェクトの最後の残りのレコードを削除した場合、現在のレコードの位置を変更するまで、BOF および EOF プロパティは False のままになることがあります。

次の表は、BOF および EOF プロパティの各種組み合わせで許可される Move メソッドを示しています。

MoveFirst、

MoveLast
MovePrevious、

Move < 0
Move 0 MoveNext、

Move > 0
BOF=TrueEOF=False 許可 エラー エラー 許可
BOF=FalseEOF=True 許可 許可 エラー エラー
両方とも True エラー エラー エラー エラー
両方とも False 許可 許可 許可 許可

Move メソッドを許可しても、メソッドがレコードを正常に見つけることが保証されるわけではありません。これが意味するのは、指定された Move メソッドを呼び出してもエラーが生成されないということだけです。

次の表は、さまざまな Move メソッドを呼び出したときにレコードを正常に見つけることができない場合の BOF および EOF プロパティ設定の動作を示しています。

BOF EOF
MoveFirst, MoveLast True に設定 True に設定
Move 0 変更なし 変更なし
MovePrevious, Move< 0 True に設定 変更なし
MoveNextMove> 0 変更なし True に設定

適用対象

Recordset オブジェクト (ADO)

参照

BOF、EOF、および Bookmark プロパティの例 (VB)
BOF、EOF、および Bookmark プロパティの例 (VC++)