CDaoRecordset::IsBOF

Artigo
08/25/2010

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