AdoServer:Skip()

<< Click to Display Table of Contents >>

Navigation:  Dataservers > AdoServer Class >

AdoServer:Skip()

Previous pageReturn to chapter overviewNext page

Purpose

Move the record pointer forward or backward a specified number of records.

 

Prototype

METHOD Skip (  nSkip ) CLASS AdoServer

 

Argument(s)

<nToSkip>        The number of records to move, relative to the current record.

 A positive value means to move forward, and a negative value means to move backward. The default is +1.

 

 

Return

LOGIC        TRUE if successful; otherwise, FALSE.  Note that a FALSE value can also indicate that beginning- or end-of-file was encountered.  Use the AdoServer:Status property to determine the reason for a failure.

 

 

The server will send a NOTIFYINTENTTOMOVE before the operation and a NOTIFYRECORDCHANGE after the operation.

 

Description

When executed successfully, this method sends a NotifyRecordChange message to this data server's clients. This operation can fail under the following conditions:

-        One of the clients returns FALSE on the NotifyIntentToMove

-        There was an error saving the changes to the current record

-        There are no records in the recordset

-        The recordset:Move() returns an error

 

 

See Also

AdoServer