Compartir a través de


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

Vea también

Referencia

Clase CDaoRecordset

Gráfico de jerarquía

CDaoRecordset::IsBOF