CDaoRecordset::IsEOF
Llame a esta función miembro al desplazarse de un registro a otro para saber si ha ido más allá del último registro de conjunto de registros.
BOOL IsEOF( ) const;
Valor devuelto
Distinto de cero si el conjunto de registros no contiene ningún registro o si se ha desplazado más allá del último registro; si no 0.
Comentarios
También puede llamar IsEOF para determinar si el conjunto de registros contiene algún registro o está vacío. Inmediatamente después de llamar a Abrir, si el conjunto de registros no contiene ningún registro, IsEOF devuelve cero. Al abrir un conjunto de registros que contiene por lo 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 devolverá posteriormente distinto de cero. Si IsEOF devuelve cero y llama a MoveNext, se produce una excepción. Si IsEOF devuelve cero, el registro actual es indefinido, y cualquier acción que requiere un registro actual producirá una excepción.
efecto de métodos específicos en IsBOF y los valores de IsEOF :
La llamada Abrir crea internamente el primer registro del conjunto de registros el registro actual llamando a MoveFirst. Por consiguiente, llamar a Abrir en conjunto vacío de registros hace IsBOF y IsEOF a cero return. (Vea la tabla siguiente para el comportamiento de una llamada errónea de MoveFirst .)
Todos mueven las operaciones que encuentran correctamente una causa de registro IsBOF y IsEOF de devolver 0.
Una llamada de AddNew seguida de una llamada de Update que inserte correctamente un nuevo registro hará IsBOF para devolver 0, pero solo si IsEOF ya es distinto de cero. Permanecerá el estado de IsEOF siempre sin modificar. Como definido por el motor de base de datos Microsoft Jet, el indicador de registro actual de un conjunto de registros vacíos está en el final de un archivo, por lo que cualquier nuevo registro se inserta a continuación del registro actual.
ninguna llamada de Eliminar , incluso si quita el único registro restante de un conjunto de registros, no cambiará el valor de IsBOF o de IsEOF.
Esta tabla muestra qué operaciones de movimiento se permiten con diferentes combinaciones de IsBOF/IsEOF.
|
MoveFirst, MoveLast |
MovePrev, movimiento < 0 |
movimiento 0 |
MoveNext, movimiento > 0 |
|---|---|---|---|---|
=nonzero deIsBOF, IsEOF=0 |
Se permite |
Excepción |
Excepción |
Se permite |
IsBOF=0, =nonzero deIsEOF |
Se permite |
Se permite |
Excepción |
Excepción |
Ambos cero |
Excepción |
Excepción |
Excepción |
Excepción |
Ambos 0 |
Se permite |
Se permite |
Se permite |
Se permite |
Permitir una operación de movimiento no significa que la operación establezca correctamente un registro. Simplemente indica que un intento de realizar la operación especificada de movimiento está permitido y no producirá una excepción. El valor de las funciones miembro de IsBOF y de IsEOF puede cambiar como resultado de movimiento frustrado.
El efecto de las operaciones de movimiento que no encuentran un registro en el valor de IsBOF y los valores de IsEOF se muestra en la tabla siguiente.
|
IsBOF |
IsEOF |
|---|---|---|
MoveFirst, MoveLast |
Cero |
Cero |
Mover 0 |
Sin cambios |
Sin cambios |
MovePrev, Mover < 0 |
Cero |
Sin cambios |
MoveNext, Mover > 0 |
Sin cambios |
Cero |
Para obtener información relacionada, vea el tema “BOF, propiedades EOF” en la Ayuda de DAO.
Requisitos
encabezado: afxdao.h