Método Move (ADO)
Se aplica a: Access 2013, Office 2013
Mueve la posición del actual registro en un objeto Recordset.
Sintaxis
conjunto de registros. Mover NumRecords, Start
Parámetros
| Parámetro | Descripción |
|---|---|
| NumRecords | Expresión de tipo Long con signo que especifica, en número de registros, el desplazamiento de la posición de registro actual. |
| Start | Es opcional. Valor de tipo String o Variant que da como resultado un marcador. También se puede utilizar un valor de BookmarkEnum. |
Comentarios
El método Move se admite en todos los objetos Recordset.
Si el argumento NumRecords es mayor que cero, la posición de registro activo avanza (hacia el final del conjunto de registros). Si NumRecords es menor que cero, la posición de registro activo retrocede (hacia el principio del conjunto de registros).
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). Cualquier intento de retroceder cuando el valor de BOF ya es True genera un error.
Si la llamada a Move mueve la posición de registro actual hasta un punto situado después del último registro, ADO establece el registro actual en la posición situada después del último registro del conjunto de registros (el valor de EOF es True). Si el valor de la propiedad EOF ya es True, cualquier intento de avanzar genera un error.
Si se llama a Move desde un objeto Recordset vacío, se genera un error.
Si pasa el argumento Start, el desplazamiento se realiza con respecto al registro con este marcador, suponiendo que el objeto Recordset admite marcadores. Si no se especifica, el desplazamiento se realiza con respecto al registro actual.
Si se utiliza la propiedad CacheSize para almacenar localmente en caché registros del proveedor, el paso de un argumento NumRecords que mueve la posición del registro activo fuera del grupo actual de registros almacenados en caché provoca que ADO recupere un nuevo grupo de registros, a partir del registro de destino. La propiedad CacheSize determina el tamaño del nuevo grupo recuperado y el registro de destino es el primer registro recuperado.
Si el objeto Recordset es de sólo avance, el usuario puede seguir pasando un argumento NumRecords cuyo valor sea menor que cero, a condición de que el destino se encuentre dentro del actual conjunto de registros almacenados en caché. Si la llamada a Move desplaza la posición de registro actual hacia un registro situado delante del primer registro almacenado en caché, se producirá un error. Por consiguiente, puede utilizar una memoria caché de registros que admita desplazamientos tanto hacia adelante como hacia atrás en lugar de un proveedor que sólo admite desplazamientos hacia adelante. Dado que los registros almacenados en caché se cargan en la memoria, deberá evitar almacenar en caché un número excesivo de registros. Incluso si un objeto Recordset de sólo avance admite de esta forma desplazamientos hacia atrás, las llamadas al método MovePrevious en los objetos Recordset de sólo avance generarán un error.
Nota:
[!NOTA] La compatibilidad con los desplazamientos hacia atrás en un objeto Recordset de sólo avance no es previsible, según el proveedor. Si la posición del actual registro se ha establecido en un punto situado después del último registro del objeto Recordset, un desplazamiento hacia atrás puede no tener la posición actual correcta como resultado.