Share via


CDaoRecordset::GetRecordCount

Llame a esta función miembro para averiguar cuántos registros en un conjunto de registros han tenido acceso.

long GetRecordCount( );

Valor devuelto

Devuelve el número de registros obtenidos en un objeto de conjunto de registros.

Comentarios

GetRecordCount no indica cuántos registros se contienen en un conjunto de registros de dynaset- tipo o de instantánea- tipo hasta que todos los registros hayan tenido acceso.Esta llamada de función miembro puede tardar mucho tiempo en completarse.

El último registro ha estado acceso una vez, el valor devuelto indica el número total de registros no desactivada en el conjunto de registros.Para forzar el último registro que se alcance, llame a la función miembro de MoveLast o de FindLast para el conjunto de registros.También puede utilizar un recuento de SQL para determinar el número de registros aproximado que la consulta devolverá.

Cuando la aplicación elimina registros en un conjunto de registros de dynaset- tipo, el valor devuelto de GetRecordCount disminuye.Sin embargo, los registros eliminados por otros usuarios no se reflejarán por GetRecordCount hasta que el registro actual se coloque un registro eliminado.Si ejecuta una transacción que afecta al número de registro y ejecuta posteriormente posterior la transacción, GetRecordCount no reflejará el número real de registros restantes.

El valor de GetRecordCount de un conjunto de registros de instantánea- tipo no afecta a los cambios en las tablas base.

El valor de GetRecordCount de un conjunto de registros de tabla- tipo refleja el número de registros aproximado en la tabla y se asigna inmediatamente cuando se agregan o eliminan registros de la tabla.

Un conjunto de registros sin registros devuelve un valor de 0.Al trabajar con tablas o bases de datos ODBC asociadas, GetRecordCount siempre devuelve – 1.Llamar a la función miembro de Requery en un conjunto de registros restablece el valor de GetRecordCount como si la consulta ha ejecutado recientemente.

Para obtener información relacionada, vea el tema “propiedades de RecordCount” en DAO Help.

Requisitos

encabezado: afxdao.h

Vea también

Referencia

Clase CDaoRecordset

Gráfico de jerarquía

CDaoRecordset::GetFieldCount

CDaoRecordset::GetFieldInfo

CDaoRecordset::GetIndexCount

CDaoRecordset::GetIndexInfo