CDaoRecordset::IsEOF

IsEOF (BOOL) const;
lançar (CDaoException, CMemoryException);

Valor de retorno

Diferente de zero se o conjunto de registros não contém registros ou se você tiver rolada além do último registro; caso contrário 0.

Observações

Chame essa função de membro enquanto você rola do registro para registro para saber se você tem ido além do último registro do conjunto de registros. Você também pode chamar IsEOF para determinar se o conjunto de registros contém registros ou está vazio. Imediatamente depois que você chamar Abrir, se o conjunto de registros não contém registros, IsEOF retorna diferente de zero. Quando você abre um conjunto de registros que tenha pelo menos um registro, o primeiro registro é o registro atual e IsEOF retorna 0.

Se o último registro é o registro atual quando você chamar MoveNext, IsEOF posteriormente irá retornar diferente de zero. Se IsEOF retorna diferente de zero e você chamar MoveNext, uma exceção é lançada. Se IsEOF retorna diferente de zero, o registro atual é indefinido e qualquer ação que requer um registro atual resultará em uma exceção.

Efeito de métodos específicos sobre configurações IsBOF e IsEOF:

Esta tabela mostra quais mover operações são permitidas com diferentes combinações de IsBOF/IsEOF.

MoveFirst, MoveLast MovePrev,

Mover < 0

Mover 0

MoveNext,

Mover > 0

IsBOF= diferente de zero,
IsEOF= 0
Permitida Exceção Exceção Permitida
IsBOF= 0,
IsEOF= diferente de zero
Permitida Permitida Exceção Exceção
Ambos diferente de zero Exceção Exceção Exceção Exceção
Ambos 0 Permitida Permitida Permitida Permitida

Permitindo que uma operação de movimentação não significa que a operação com êxito irá localizar um registro. Ele simplesmente indica que uma tentativa de executar a operação mover especificada é permitida e não irá gerar uma exceção. O valor das funções de membro IsBOF e IsEOF pode mudar como resultado do movimento tentativa.

O efeito de mover operações que não localizar um registro sobre o valor das configurações IsBOF e IsEOF é mostrado na tabela a seguir.

IsBOF IsEOF
MoveFirst, MoveLast Diferente de zero Diferente de zero
Mover 0 Sem alteração Sem alteração
MovePrev, Mover < 0 Diferente de zero Sem alteração
MoveNext, Mover > 0 Sem alteração Diferente de zero

Para obter mais informações sobre como navegar em conjuntos de registros, consulte o artigo DAO Recordset: navegação do conjunto de registros no Guia do programador do Visual C++. Para obter informações relacionadas, consulte o tópico "BOF, propriedades EOF" na Ajuda do DAO.

Visão geral de CDaoRecordsetMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CDaoRecordset::IsBOF

Index