Propiedad RecordCount (ADO)

Indica el número de registros de un objeto Recordset.

Valor devuelto

Devuelve un valor Long que indica el número de registros del objeto Recordset.

Comentarios

Utilice la propiedad RecordCount para averiguar cuántos registros hay en un objeto Recordset. La propiedad devuelve -1 cuando ADO no puede determinar el número de registros o si el tipo de proveedor o cursor no admite RecordCount. La lectura de la propiedad RecordCount en un objeto Recordset cerrado provoca un error.

Marcadores o posicionamiento aproximado

Si el objeto Recordset admite marcadores o posicionamiento aproximado, esta propiedad devuelve el número exacto de registros del objeto Recordset. Esta propiedad devuelve el número exacto independientemente de si el objeto Recordset se ha rellenado por completo.

Por el contrario, si el objeto Recordset no admite marcadores ni posicionamiento aproximado, el acceso a esta propiedad podría suponer una purga significativa de los recursos. La purga se produce porque todos los registros deben recuperarse y contarse para devolver un valor RecordCount preciso.

• adBookmark se relaciona con los marcadores.
• adApproxPosition se relaciona con el posicionamiento aproximado.

Nota

En las versiones 2.8 y anteriores de ADO, el proveedor SQLOLEDB captura todos los registros cuando se usa un cursor del lado servidor, a pesar de que devuelve True para Supports (adApproxPosition) y Supports (adBookmark).

El tipo de cursor del objeto Recordset afecta al hecho de que se pueda determinar el número de registros. La propiedad RecordCount devolverá -1 para un cursor de sólo avance; el recuento real de un cursor estático o de un conjunto de claves; y -1 o el recuento real de un cursor dinámico, en función del origen de datos.

Se aplica a

Objeto de conjunto de registros (ADO)

Consulte también

Ejemplo de las propiedades Filter y RecordCount (VB)
Ejemplo de las propiedades Filter y RecordCount (VC++)
Propiedad AbsolutePosition (ADO)
PageCount (propiedad, ADO)