CDaoRecordset::IsBOF

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

Valor devuelto

Distinto de cero si el recordset no contiene registros o si se ha desplazado hacia atrás antes del primer registro; caso contrario 0.

Observaciones

Llame a esta función miembro antes de desplazarse de registro a registro para saber si han ido antes del primer registro del objeto recordset. También puede llamar a IsBOF junto con 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, IsBOF devuelve cero. Al abrir un juego de registros que tiene al menos un registro, el primer registro es el registro actual y IsBOF devuelve 0.

Si el primer registro es el registro actual y se llama MovePrev, IsBOF posteriormente devolverá cero. Si IsBOF devuelve cero y se llama MovePrev, se produce una excepción. Si IsBOF 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::IsEOF

Index