EOF Property

The EOF property on a Recordset object indicates that the current record position is after the last record in a Recordset object. This property returns a Boolean value.

IsEOF = recordset.EOF
 

Remarks

The EOF property is used to determine whether a Recordset object contains records or whether you have gone beyond the limits of a Recordset object when you move from record to record.

The EOF property returns True if the current record position is after the last record and False if the current record position is on or before the last record.

If the EOF property is True, there is no current record.

If a Recordset object is opened containing no records, both the BOF and EOF properties are set to True, and the Recordset object's RecordCount property setting is zero. When a Recordset object is opened that contains at least one record, the first record is the current record and the BOF and EOF properties are False.

If the last remaining record in the Recordset object is deleted, the BOF and EOF properties may remain False until you attempt to reposition the current record.

This table below indicates which Move methods are allowed with different combinations of the BOF and EOF properties.

MoveFirst
MoveLast
MovePrevious
Move < 0
Move 0 MoveNext
Move > 0
BOF=True
EOF=False
Allowed Error Error Allowed
BOF=False
EOF=True
Allowed Allowed Error Error
Both True Error Error Error Error
Both False Allowed Allowed Allowed Allowed

Allowing a Move method does not guarantee that the method will successfully locate a record; it only means that calling the specified Move method will not generate an error.

The following table shows what happens to the BOF and EOF property settings when various Move methods are called but are unable to successfully locate a record.

BOF Property EOF Property
MoveFirst
MoveLast
Set to True Set to True
Move 0 No change No change
MovePrevious
Move < 0
Set to True No change
MoveNext
Move > 0
No change Set to True