CDaoRecordset::IsBOF

IsBOF (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 para trás antes do primeiro registro; caso contrário 0.

Observações

Chame essa função de membro antes você rola do registro para registro para saber se você tem ido antes do primeiro registro do conjunto de registros. Você também pode chamar IsBOF juntamente com 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, IsBOF retorna diferente de zero. Quando você abre um conjunto de registros que tenha pelo menos um registro, o primeiro registro é o registro atual e IsBOF retorna 0.

Se o primeiro registro é o registro atual e você chamar MovePrev, IsBOF posteriormente retornará diferente de zero. Se IsBOF retorna diferente de zero e você chamar 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 sobre configurações IsBOF e IsEOF:

Chamar Abrir internamente torna o primeiro registro no conjunto de registros do registro atual chamando MoveFirst. Portanto, chamar aberto em um conjunto de registros vazio faz IsBOF e IsEOF retornar diferente de zero. (Consulte a tabela a seguir para o comportamento de uma falha chamar MoveFirst ou MoveLast ).
Fazer com que todas as operações de mover com êxito localizar um registro ambos IsBOF e IsEOF retornam 0.
Um chamar AddNew seguido por uma chamada de atualização com êxito insere um novo registro irá causar IsBOF retornar 0, mas apenas se IsEOF já é diferente de zero. O estado de IsEOF sempre permanecerá inalterado. Conforme definido pelo mecanismo de banco de dados do Microsoft Jet, o ponteiro do registro atual de um conjunto de registros vazio é no final de um arquivo, portanto, qualquer novo registro é inserido após o registro atual.
Qualquer Excluir chamada, mesmo que ele remove o único registro restante de um conjunto de registros não alterará o valor de IsBOF ou 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 CDaoRecordset | Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CDaoRecordset::IsEOF

Index