CRecordset::IsBOF

Artigo
02/25/2013

Retorna diferente de zero se o conjunto de registros está posicionado antes do primeiro registro.Não há nenhum registro atual.

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

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.Você também pode usar 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, 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 rola de código com o conjunto de registros em ambas as direções.

// Open a recordset; first record is current
CCustomer rsCustSet(&m_dbCust);
rsCustSet.Open();

if(rsCustSet.IsBOF())
   return;
   // The recordset is empty

// Scroll to the end of the recordset, past
// the last record, so no record is current
while (!rsCustSet.IsEOF())
   rsCustSet.MoveNext();

// Move to the last record
rsCustSet.MoveLast();

// Scroll to beginning of the recordset, before
// the first record, so no record is current
while(!rsCustSet.IsBOF())
   rsCustSet.MovePrev();

// First record is current again
rsCustSet.MoveFirst();