Método Move (ADO)
Mueve la posición del registro actual en un objeto Recordset de .
Sintaxis
recordset.Move NumRecords, Start
Parámetros
NumRecords
Expresión long firmada que especifica el número de registros que mueve la posición actual del registro.
inicio
Opcional. Valor string o Variant que se evalúa como un marcador. También puede usar un valor de BookmarkEnum.
Observaciones
El método Move se admite en todos los objetos recordset de .
Si el argumento NumRecords es mayor que cero, la posición del registro actual avanza (hacia el final del Recordset). Si NumRecords es menor que cero, la posición del registro actual se mueve hacia atrás (hacia el principio del Recordset).
Si la llamada Move movería la posición del registro actual a un punto antes del primer registro, ADO establece el registro actual en la posición anterior al primer registro del conjunto de registros ( BOF es True). Un intento de retroceder cuando la propiedad BOF ya está True genera un error.
Si la llamada move movería la posición del registro actual a un punto después del último registro, ADO establece el registro actual en la posición después del último registro del conjunto de registros ( EOF es True). Un intento de avanzar cuando la propiedad EOF ya está True genera un error.
Al llamar al método Move desde un objeto Recordset vacío se 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 caché localmente 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 de 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 Move movería 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 sobre un proveedor que solo admite el desplazamiento hacia delante. Dado que los registros almacenados en caché se cargan en 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, al llamar al método MovePrevious en cualquier objeto recordset de solo avance objeto se generará un error.
Nota
La compatibilidad con el movimiento hacia atrás en un recordset de solo avance no es predecible, dependiendo de su proveedor. Si el registro actual se ha colocado después del último registro del recordset, es posible que Mover hacia atrás no produzca la posición actual correcta.
Se aplica a
Consulte también
Ejemplo del método Move de (VB)
Ejemplo del método Move de (VBScript)
Ejemplo del método Move de (VC++)
métodos MoveFirst, MoveLast, MoveNext y MovePrevious (ADO)
métodos MoveFirst, MoveLast, MoveNext y MovePrevious (RDS)
método MoveRecord (ADO)