CDaoRecordset::IsBOF
telefonar Essa função de membro antes de que Role do registro para registro para saber se você passou antes do primeiro registro do conjunto de registros.
BOOL IsBOF( ) const;
Valor de retorno
Diferente de zero se o conjunto de registros não contém registros ou se você percorreu para trás antes do primeiro registro; caso contrário, 0.
Comentários
Você também pode telefonar IsBOF juntamente com IsEOF para determinar se o conjunto de registros contém os registros ou está vazio. Imediatamente após você telefonar em aberto, se o conjunto de registros não contiver registros, IsBOF Retorna um diferente de zero. Quando você abre um conjunto de registros que tenha pelo menos um registro, o primeiro registro é o registro corrente e IsBOF Retorna 0.
Se o primeiro registro é o registro corrente e você telefonar MovePrev, IsBOF em seguida, retornará diferentes de zero. If IsBOF Retorna diferente de zero e você chamar MovePrev, uma exceção é lançada. If IsBOF Retorna diferente de zero, o registro corrente é indefinido e qualquer ação que requer um registro corrente resultará em uma exceção.
Efeito de métodos específicos no IsBOF e IsEOF configurações:
De chamadaem aberto internamente torna o primeiro registro no conjunto de registros o registro corrente chamando MoveFirst.Portanto, chamar em aberto faz com que em um conjunto vazio de registrosIsBOF e IsEOF para retornar diferentes de zero. (Consulte a tabela a seguir para o comportamento de uma falha MoveFirst or MoveLast telefonar).
Ambos os fazer com que todas as operações de mover localizar um registro com êxitoIsBOF e IsEOF para retornar a 0.
An AddNew telefonar seguido por um Atualização telefonar que insere um novo registro com êxito fará com que IsBOF para retornar a 0, mas apenas 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 do registro corrente de um conjunto de registros vazio está no participante de um arquivo, portanto, qualquer novo registro é inserido após o registro corrente.
Any Excluir telefonar, mesmo se ele remove o único registro restante de um conjunto de registros, não irá alterar o valor de IsBOF ou IsEOF.
Esta tabela mostra qual mover as operações são permitidas com combinações diferentes de IsBOF/IsEOF.
|
MoveFirst, MoveLast |
MovePrev, Mover < 0 |
Mover 0 |
MoveNext, Mover > 0 |
---|---|---|---|---|
IsBOF= diferente de zero, IsEOF=0 |
Permitido |
Exceção |
Exceção |
Permitido |
IsBOF=0, IsEOF= diferente de zero |
Permitido |
Permitido |
Exceção |
Exceção |
Ambos diferente de zero |
Exceção |
Exceção |
Exceção |
Exceção |
Os dois 0 |
Permitido |
Permitido |
Permitido |
Permitido |
Permitindo que uma operação de movimentação não significa que a operação com êxito localizará um registro.Ele simplesmente indica que uma tentativa de executar a operação de mover especificada é permitida e não irá gerar uma exceção.O valor de IsBOF e IsEOF funções de membro podem ser alteradas sistema autônomo resultado da movimentação tentada.
O efeito de mover operações que não localizar um registro no valor de IsBOF e IsEOF configurações é 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 obter informações relacionadas, consulte o tópico "BOF, EOF Properties" na Ajuda do DAO.
Requisitos
Cabeçalho: afxdao.h