last( )

Topic group Related topics

Moves the row cursor to the last row in the rowset.

Syntax

<oRef>.last( )

<oRef>

The rowset in which you want to move the row cursor.

Property of

Rowset

Description

Call last( ) to move the row cursor to the last row in the rowset. If a filter is active, it moves the row cursor to the last row in the rowset that matches the filter criteria.

As a navigation method, last( ) interacts with canNavigate, onNavigate, and implicit saves. For more information, see next( ).

If a call to last( ) results in the endOfSet property returning true, either no rows remain that match the filter criteria or, if no filter is in use, no rows remain in the rowset.

Going to the last row in a rowset may not be an optimized operation on some SQL servers. For those servers, calling last( ) may take a long time for large rowsets.

Note

Using the rowset's navigateByMaster property to synchronize movement in master-detail rowsets, modifies the behavior of the atLast( ) method. See navigateByMaster for more information.