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:

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 .)
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::IsBOF

Index