Move (método) (ADO)

Mueve la posición del registro actual en un objeto Recordset.

Sintaxis

  
recordset.Move NumRecords, Start  

Parámetros

NumRecords
Expresión Long firmada que especifica el número de registros que mueve la posición del registro actual.

Iniciar
Opcional. Valor String o Variant que se evalúa como un marcador. También puede usar un valor BookmarkEnum.

Comentarios

El método Move se admite en todos los objetos Recordset.

Si el argumento NumRecords es mayor que cero, la posición del registro actual avanza (hacia el final del objeto Recordset). Si NumRecords es menor que cero, la posición del registro actual retrocede (hacia el principio del objeto Recordset).

Si la llamada a Move moviera la posición del registro actual a un punto anterior al primer registro, ADO establece el registro actual en la posición anterior al primer registro del objeto Recordset (BOF es True). Un intento de retroceder cuando la propiedad BOF ya es True genera un error.

Si la llamada a Move moviera la posición del registro actual a un punto posterior al último registro, ADO establece el registro actual en la posición posterior al último registro del objeto Recordset (EOF es True). Un intento de avanzar cuando la propiedad EOF ya es True genera un error.

La llamada al método Move desde un objeto Recordset vacío genera un error.

Si pasa el argumento Start, el movimiento es relativo al registro con este marcador, suponiendo que el objeto Recordset admite marcadores. Si no se especifica, el movimiento es relativo al registro actual.

Si usa la propiedad CacheSize para almacenar en la caché local los registros del proveedor, pasando un argumento NumRecords que mueve la posición del registro actual fuera del grupo actual de registros almacenados en caché obliga a ADO a recuperar un nuevo grupo de registros, empezando por el registro de destino. La propiedad CacheSize determina el tamaño del grupo recién recuperado y el registro de destino es el primer registro recuperado.

Si el objeto Recordset solo se reenvía, un usuario todavía puede pasar un argumento NumRecords menor que cero, siempre que el destino esté dentro del conjunto actual de registros almacenados en caché. Si la llamada a Move moviera la posición del registro actual a un registro antes del primer registro almacenado en caché, se producirá un error. Por lo tanto, puede usar una caché de registros que admita el desplazamiento completo por un proveedor que solo admite el desplazamiento hacia delante. Dado que los registros almacenados en caché se cargan en la memoria, debe evitar almacenar en caché más registros de los necesarios. Incluso si un objeto Recordset de solo avance admite movimientos hacia atrás de esta manera, llamar al método MovePrevious en cualquier objeto Recordset de solo avance seguirá generando un error.

Nota

La compatibilidad con el movimiento hacia atrás en un objeto Recordset de solo avance no es predecible, dependiendo de su proveedor. Si el registro actual se ha colocado después del último registro en el objeto Recordset, es posible que el desplazamiento hacia atrás de Move no consiga la posición actual correcta.

Se aplica a

Objeto de conjunto de registros (ADO)

Consulte también

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