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=True、EOF=False | 許可 | エラー | エラー | 許可 |
| BOF=False、EOF=True | 許可 | 許可 | エラー | エラー |
| 両方とも True | エラー | エラー | エラー | エラー |
| 両方とも False | 許可 | 許可 | 許可 | 許可 |
Move メソッドを許可しても、メソッドがレコードを正常に見つけることが保証されるわけではありません。これが意味するのは、指定された Move メソッドを呼び出してもエラーが生成されないということだけです。
次の表は、さまざまな Move メソッドを呼び出したときにレコードを正常に見つけることができない場合の BOF および EOF プロパティ設定の動作を示しています。
| BOF | EOF | |
|---|---|---|
| MoveFirst, MoveLast | True に設定 | True に設定 |
| Move 0 | 変更なし | 変更なし |
| MovePrevious, Move< 0 | True に設定 | 変更なし |
| MoveNext、Move> 0 | 変更なし | True に設定 |
適用対象
参照
BOF、EOF、および Bookmark プロパティの例 (VB)
BOF、EOF、および Bookmark プロパティの例 (VC++)