(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 < 0 | True に設定 | 変化なし |
MoveNext、Move > 0r | 変化なし | True に設定 |