Propiedad CacheSize (ADO)

Indica el número de registros de un objeto Recordset que se almacenan en la memoria caché local.

Configuración y valores devueltos

Establece o devuelve un valor Long que debe ser mayor que 0. El valor predeterminado es 1.

Comentarios

Use la propiedad CacheSize para controlar el número de registros que se van a recuperar a la vez en la memoria local del proveedor. Por ejemplo, si CacheSize es 10, después de abrir el objeto Recordset por primera vez, el proveedor recupera los primeros 10 registros en la memoria local. A medida que se desplaza por el objeto Recordset, el proveedor devuelve los datos del búfer de memoria local. Tan pronto como pase el último registro de la memoria caché, el proveedor recupera los 10 registros siguientes del origen de datos en la memoria caché.

Nota

CacheSize se basa en la propiedad específica del proveedor Número máximo de filas abiertas (en la colección Properties del objeto Recordset). No se puede establecer CacheSize en un valor mayor que Número máximo de filas abiertas. Para modificar el número de filas que puede abrir el proveedor, establezca Número máximo de filas abiertas.

El valor de CacheSize se puede ajustar durante la vida del objeto Recordset, pero cambiar este valor solo afecta al número de registros de la memoria caché después de las posteriores recuperaciones del origen de datos. Cambiar solo el valor de la propiedad no cambiará el contenido actual de la memoria caché.

Si hay menos registros que recuperar de los que CacheSize especifica, el proveedor devuelve los registros restantes y no se produce ningún error.

No se permite una configuración de CacheSize de cero, ya que devuelve un error.

Los registros recuperados de la memoria caché no reflejan los cambios simultáneos realizados por otros usuarios en los datos de origen. Para forzar una actualización de todos los datos almacenados en caché, use el método Resync.

Si CacheSize se establece en un valor mayor que uno, los métodos de navegación (Move, MoveFirst, MoveLast, MoveNext y MovePrevious) pueden provocar la eliminación de un registro durante la navegación, en caso de que la eliminación tenga lugar después de recuperar los registros. Después de la recuperación inicial, las eliminaciones posteriores no se reflejarán en la memoria caché de datos hasta que intente acceder a un valor de datos desde una fila eliminada. Sin embargo, este problema se resuelve al establecer CacheSize en uno, ya que no se pueden recuperar filas eliminadas.

Se aplica a

Objeto de conjunto de registros (ADO)

Consulte también

Ejemplo de la propiedad CacheSize (VB)
Ejemplo de la propiedad CacheSize (VC ++)
Ejemplo de la propiedad CacheSize (JScript)