CDaoRecordset::IsBOF
Chamar essa função de membro antes de rolar registro do registro para saber se você vai antes do primeiro registro do conjunto de registros.
BOOL IsBOF( ) const;
Valor de retorno
Diferente de zero se o recordset não contém nenhum registro ou se você foi rolado para trás antes do primeiro registro; se não 0.
Comentários
Você também pode chamar IsBOF juntamente com IsEOF para determinar se o recordset contém quaisquer registros ou está vazia.Imediatamente após você chama Abrir, se o recordset não contém nenhum registro, IsBOF retorna diferente de zero.Quando você abre um conjunto de registros que tenha pelo menos um registro, o primeiro registro é retorna 0 do registro atual e de IsBOF .
Se o primeiro registro é o registro atual e você chama MovePrev, IsBOF retornará posteriormente diferente de zero.Se IsBOF retorna diferente de zero e você chama MovePrev, uma exceção é lançada.Se IsBOF 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 em IsBOF e nas configurações de IsEOF :
A chamada Abrir internamente torna um registro para o primeiro registro no conjunto de registros atual chamando MoveFirst.Portanto, chame Abrir em um conjunto vazio de registros causa IsBOF e IsEOF a diferente de zero de retorno.(Consulte a tabela a seguir para o comportamento de MoveFirst ou de uma chamada falha de MoveLast .)
Ele move todos as operações que atendam com êxito uma causa IsBOF e IsEOF do registro retornar 0.
Uma chamada de AddNew seguido por um Atualizar de chamada bem-sucedida que insere um novo registro fará com que IsBOF retorna 0, mas somente se IsEOF já é diferente de zero.O estado de IsEOF sempre permanecerá inalterada.Conforme definido pelo mecanismo de banco de dados Microsoft Jet, o ponteiro de registro atual de um conjunto de registros está vazia no fim de um arquivo, então qualquer novo registro é inserido após o registro atual.
Nenhuma chamada de Excluir , mesmo se remove o registro restante de um conjunto de registros, não irá alterar o valor de IsBOF ou de IsEOF.
Esta tabela mostra que operações de animação são permitidas com as diferentes combinações de IsBOF/IsEOF.
|
MoveFirst, MoveLast |
MovePrev, Mover < 0 |
Mover 0 |
MoveNext, Mover > 0 |
|---|---|---|---|---|
=nonzero deIsBOF, IsEOF=0 |
Reservado |
Exceção |
Exceção |
Reservado |
IsBOF=0, =nonzero deIsEOF |
Reservado |
Reservado |
Exceção |
Exceção |
Ambos diferente de zero |
Exceção |
Exceção |
Exceção |
Exceção |
Ambos 0 |
Reservado |
Reservado |
Reservado |
Reservado |
Permitir uma operação de animação não significa que a operação permanecerá com êxito um registro.Simplesmente indica que uma tentativa de executar a operação especificada de animação é permitida e não gerará uma exceção.O valor das funções de membro de IsBOF e de IsEOF pode alterar o resultado de movimentação tentada.
O efeito das operações de animação que não atenderem um registro no valor de IsBOF e configurações de IsEOF é mostrado na tabela a seguir.
|
IsBOF |
IsEOF |
|---|---|---|
MoveFirst, MoveLast |
Diferente de zero |
Diferente de zero |
Mover 0 |
Nenhuma alteração |
Nenhuma alteração |
MovePrev, Mover < 0 |
Diferente de zero |
Nenhuma alteração |
MoveNext, Mover > 0 |
Nenhuma alteração |
Diferente de zero |
Para informações relacionadas, consulte o tópico “BOF, propriedades de EOF” na ajuda de DAO.
Requisitos
Cabeçalho: afxdao.h