Métodos MoveFirst, MoveLast, MoveNext y MovePrevious (ADO)

Se mueve al primer, último, siguiente o anterior registro de un objeto Recordset especificado y hace que el registro sea el registro actual.

Sintaxis

  
recordset.{MoveFirst | MoveLast | MoveNext | MovePrevious}  

Comentarios

Use el método MoveFirst para mover la posición del registro actual al primer registro del objeto Recordset.

Use el método MoveLast para mover la posición del registro actual al último registro del objeto Recordset. El objeto Recordset debe admitir marcadores o movimiento de cursor hacia atrás; de lo contrario, la llamada al método generará un error.

Una llamada a MoveFirst o MoveLast cuando el objeto Recordset está vacío (BOF y EOF son True) genera un error.

Use el método MoveNext para mover la posición de registro actual un registro hacia delante (hacia la parte inferior del objeto Recordset). Si el último registro es el registro actual y se llama al método MoveNext, ADO establece el registro actual en la posición después del último registro del objeto Recordset (EOF es True). Un intento de avanzar cuando la propiedad EOF ya es True genera un error.

En ADO 2.5 y versiones posteriores, cuando el objeto Recordset se ha filtrado u ordenado y se cambian los datos del registro actual, al llamar al método MoveNext el cursor se mueve dos registros hacia delante desde el registro actual. Esto se debe a que cuando se cambia el registro actual, el siguiente registro se convierte en el nuevo registro actual. Llamar a MoveNext después del cambio mueve el cursor un registro hacia delante desde el nuevo registro actual. Esto difiere del comportamiento de ADO 2.1 y versiones anteriores. En estas versiones anteriores, cambiar los datos de un registro actual en el objeto Recordset ordenado o filtrado no cambia la posición del registro actual y MoveNext mueve el cursor al siguiente registro inmediatamente después del registro actual.

Use el método MovePrevious para mover la posición de registro actual un registro hacia detrás (hacia la parte superior del objeto Recordset). El objeto Recordset debe admitir marcadores o movimiento de cursor hacia atrás; de lo contrario, la llamada al método generará un error. Si el último registro es el registro actual y se llama al método MovePrevious, ADO establece el registro actual en la posición previa al último registro del objeto Recordset (BOF es True). Un intento de retroceder cuando la propiedad BOF ya es True genera un error. Si el objeto Recordset no admite marcadores o movimiento de cursor hacia atrás, el método MovePrevious generará un error.

Si el objeto Recordset es solo hacia delante y desea admitir el desplazamiento hacia delante y hacia atrás, puede usar la propiedad CacheSize para crear una caché de registros que admita el movimiento del cursor hacia atrás a través del método Move. Dado que los registros almacenados en caché se cargan en la memoria, debe evitar almacenar en caché más registros de los necesarios. Puede llamar al método MoveFirst en un objeto Recordset de solo avance; si lo hace, puede que el proveedor vuelva a ejecutar el comando que generó el objeto Recordset.

Se aplica a

Objeto de conjunto de registros (ADO)

Consulte también

Ejemplo de métodos MoveFirst, MoveLast, MoveNext y MovePrevious (VB)
Ejemplo de métodos MoveFirst, MoveLast, MoveNext y MovePrevious (VBScript)
Ejemplo de métodos MoveFirst, MoveLast, MoveNext y MovePrevious (VC++)
Move (método) (ADO)
MoveFirst, MoveLast, MoveNext y MovePrevious métodos (RDS)
Método MoveRecord (ADO)