CDaoRecordset::IsEOF

BOOL IsEOF () const;
Tiro (CDaoException, CMemoryException);

Valor devuelto

Distinto de cero si el recordset no contiene registros o si se ha desplazado más allá del último registro; caso contrario 0.

Observaciones

Llame a esta función miembro al desplazarse de registro a registro para conocer si han superado el último registro del conjunto de registros. También puede llamar a IsEOF para determinar si el juego de registros contiene todos los registros o está vacío. Inmediatamente después de llamar a Open, si el recordset no contiene registros, IsEOF devuelve cero. Al abrir un juego de registros que tiene al menos un registro, el primer registro es el registro actual y IsEOF devuelve 0.

Si el último registro es el registro actual cuando se llama a MoveNext, IsEOF posteriormente devolverá cero. Si IsEOF devuelve cero y llamar a MoveNext, se produce una excepción. Si IsEOF devuelve cero, el registro actual no está definido, y cualquier acción que requiere un registro actual dará como resultado una excepción.

Efecto de métodos específicos de configuración IsBOF y IsEOF:

Esta tabla muestra las operaciones de traslado son permitidas con diferentes combinaciones de IsBOFyIsEOF.

MoveFirst, MoveLast MovePrev,

Mover < 0

Mover 0

MoveNext,

Mover > 0

IsBOF= distinto de cero,
IsEOF= 0
Permitido Excepción Excepción Permitido
IsBOF= 0,
IsEOF= cero
Permitido Permitido Excepción Excepción
Tanto distinto de cero Excepción Excepción Excepción Excepción
Ambos 0 Permitido Permitido Permitido Permitido

Lo que permite una operación de movimiento no significa que la operación será localizar correctamente un registro. Simplemente indica que un intento de realizar la operación de desplazamiento especificada está permitido y no generará una excepción. El valor de las funciones miembro IsBOF y IsEOF puede cambiar como resultado de la tentativa mover.

En la siguiente tabla se muestra el efecto de las operaciones de traslado que no busque un registro sobre el valor de configuración IsBOF y IsEOF.

IsBOF IsEOF
MoveFirst, MoveLast Distinto de cero Distinto de cero
Mover 0 Ningún cambio Ningún cambio
MovePrev, Mover < 0 Distinto de cero Ningún cambio
MoveNext, Mover > 0 Ningún cambio Distinto de cero

Para obtener más información sobre navegación en conjuntos de registros, vea el artículo conjunto de registros DAO: conjunto de registros de navegación en la Guía del programador de Visual C++. Para obtener información relacionada, vea el tema "BOF, EOF propiedades" en la ayuda de DAO.

Visió&n General de CDaoRecordset |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CDaoRecordset::IsBOF

Index