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