ADO: ActiveX Data Objects

Name

Recordset.AbsolutePosition Property — (Versions 2.0, 2.1, 2.5, 2.6)

Synopsis

absoluteposition = recordset.AbsolutePosition

The AbsolutePosition property returns or sets a value that indicates the current record position within the recordset.

Datatype

Long

Description

By setting the AbsolutePosition property, you are instructing ADO to move to the record with the ordinal position that you specified. The AbsolutePosition property can be set from 1 to the number returned by the RecordCount property, which is the total number of records in the recordset.

When you set the AbsolutePosition property, ADO reloads the cache with a new set of records, the first one of which is the record that you specify. The number of records that are loaded in the cache is determined by the CacheSize property.

By reading the AbsolutePosition property, you can determine at which ordinal position the record pointer is located by the Long or the PositionEnum value.

If, when reading the AbsolutePosition property, the record pointer is pointing to the BOF marker, then the value adPosBOF (-2) is returned. If the record pointer is at the EOF marker, then the adPosEOF (-3) value is returned. If the recordset is empty, if the record pointer’s position is unknown, or if the data provider does not support the AbsolutePosition property, then the value adPosUnknown (-1) is returned.

It is important to note that the AbsolutePosition can change in the event that a previous record is deleted or even if the recordset is required. ...