CRecordset::IsBOF

BOOL IsBOF( ) const;

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 usar IsBOF e 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, ocorrerá um erro. Se IsBOF retorna diferente de zero, o registro atual é indefinido e qualquer ação que requer um registro atual resultará em um erro.

Exemplo

Este exemplo usa IsBOF e IsEOF para detectar os limites de um conjunto de registros como o código percorre o conjunto de registros em ambas as direções.

/ / Abrir um conjunto de registros; primeiro registro é atual
CCustSet rsCustSet (&NULL);
rsCustSet.Open ();

se (rsCustSet.IsBOF ())
 nbsp;  retornar;
    / / O conjunto de registros é vazio

/ / Role até o final do conjunto de registros, do passado
/ / o último registro, portanto, não há registro é atual
enquanto (! rsCustSet.IsEOF ())
    rsCustSet.MoveNext ();

/ / Move para o último registro
rsCustSet.MoveLast ();

/ / Rolar para o início do conjunto de registros, antes
/ / o primeiro registro, portanto, não há registro é atual
enquanto (! rsCustSet.IsBOF ())
    rsCustSet.MovePrev ();

/ / Primeiro registro é atual novamente
(rsCustSet.MoveFirst)

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

Co&nsulte tambémnbsp;CRecordset::IsEOF, CRecordset::MoveFirst, CRecordset::MovePrev

Index