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:

Llamar a Open internamente hace el primer registro del conjunto de registros del registro actual llamando MoveFirst. Por lo tanto, llamando a Abrir en un conjunto vacío de registros hace IsBOF y IsEOF devuelven distinto de cero. (Consulte la tabla siguiente para el comportamiento de una fallida convocatoria MoveFirst o MoveLast ).
Todas las operaciones de movimiento que localizar correctamente un registro causar tanto a IsBOF y IsEOF devuelven 0.
Una llamada de AddNew seguida de una llamada de actualización correctamente inserta un nuevo registro causará IsBOF volver a 0, pero sólo si IsEOF ya es distinto de cero. El estado de IsEOF siempre permanecerá sin cambios. Definido por el motor de base de datos de Microsoft Jet, el puntero del registro actual de un objeto recordset vacío es al final de un archivo, por lo que cualquier nuevo registro se insertará después del registro actual.
Cualquier llamada de Eliminar , incluso si quita el único registros de un recordset, no cambiará el valor de IsBOF o 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