Click or drag to resize

DbGoTop Function

Move to the first logical record.

Namespace:  XSharp.RT
Assembly:  XSharp.RT (in XSharp.RT.dll) Version: 2.08
Syntax
 FUNCTION DbGoTop() AS LOGIC
View Source

Return Value

Type: Boolean
TRUE if successful; otherwise, FALSE.
Remarks
By default, this function operates on the currently selected work area.  It can be made to operate on an unselected work area by specifying it within an aliased expression. DBGoTop() performs the same function as the GO TOP command.
Tip Tip
Logical records: DBGoTop() operates on logical records.  If the work area has an active order list, DBGoTop() moves to the first record in the controlling order.  If a filter is set, only records which meet the filter condition are considered. Shared mode: For a shared file, moving to a different record can cause updates to the current record to become visible to other processes.  For more information, refer to "Concurrency Control" in the Programmer's Guide.
Examples
This example demonstrates the typical use of DBGoTop():
X#
DBGoTop()
WHILE (!EOF())
        QOut(_FIELD->Name)
        DBSkip()
END
See Also