サンプルコードで学ぶASP

(PWS4 IIS4 IIS5)
BOF — カレント レコードの位置が Recordset オブジェクトの最初のレコードより前にあることを示します。

構文

object.BOF

パラメータ

戻り値

BOF プロパティは、ブール型 (Boolean) の値を返します。

説明

BOF プロパティと EOF プロパティは、Recordset オブジェクトにレコードが格納されているか、またはレコード間を移動したときに Recordset オブジェクトの制限を超えたかどうかを確認するときに使います。

BOF プロパティは、カレント レコードの位置が最初のレコードより前にある場合は True (-1) を返し、カレント レコードの位置が最初のレコード上またはそれ以降にある場合は False (0) を返します。

BOF プロパティが True の場合、カレント レコードはありません。

レコードを持たない Recordset を開くと、BOF プロパティは True に設定されます (Recordset のこの状態については、RecordCount プロパティを参照してください)。少なくとも 1 つのレコードが格納された Recordset オブジェクトを開くと、最初のレコードがカレント レコードになり、BOF プロパティと EOF プロパティは False になります。

Recordset オブジェクトで最後に残ったレコードを削除しても、カレント レコードの位置を移動するまで BOF プロパティは False のままです。

次の表では、BOF プロパティの設定値の組み合わせと、利用できる Move メソッドの種類を示します。

Move メソッドが使えても、そのメソッドによるレコードの位置が見つかったとは限りません。メソッドが使えるとは、指定された Move メソッドを呼び出してもエラーが発生しなかったことを意味するだけです。

次の表は、さまざまな Move メソッドを呼び出してもレコードの位置が見つからない場合に、BOF プロパティに設定される値を示します。