EOF

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

構文

object.EOF

パラメータ

object
Recordset オブジェクトを指定します。

戻り値

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

説明

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

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

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

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

MoveFirst、MoveLast MovePrevious、Move < 0 Move 0 MoveNext、Move > 0
BOF=True、EOF=False 使用可能 エラー エラー 使用可能
BOF=False、EOF=Truee 使用可能 使用可能 エラー エラー
両方が True エラー エラー エラー エラー
両方が False 使用可能 使用可能 使用可能 使用可能

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

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

BOF EOF
MoveFirst、MoveLast True に設定 True に設定
Move 0 変化なし 変化なし
MovePrevious、Move &lt; 0 True に設定 変化なし
MoveNext、Move &gt; 0r 変化なし True に設定