CDaoRecordset::IsBOF

Chiamare la funzione membro prima che ci si sposta da un record a per sapere se è necessario prima che il primo record del recordset.

BOOL IsBOF( ) const;

Valore restituito

Diverso da zero se il recordset non contiene record o se si è spostato indietro prima del primo record, in caso contrario 0.

Note

È anche possibile chiamare IsBOF con IsEOF per determinare se il recordset contiene i record o è vuoto.Subito dopo avere chiamato Apri, se il recordset non contiene record, IsBOF restituisce diverso da zero.Quando si apre un recordset con almeno un record, il primo record è restituisce 0 IsBOF e del record corrente.

Se il primo record è il record corrente e chiamate MovePrev, IsBOF restituirà un valore diverso da zero.Se IsBOF restituisce diverso da zero e chiamate MovePrev, viene generata un'eccezione.Se IsBOF restituisce diverso da zero, il record corrente viene definito e qualsiasi azione che richiede un record corrente genereranno un'eccezione.

Effetto dei metodi specifici su IsBOF e le impostazioni IsEOF :

  • Chiamare Apri internamente imposta il primo record del recordset il record corrente chiamando MoveFirst.Di conseguenza, chiamare Apri su un insieme di record vuoto provoca IsBOF e IsEOF a restituire diverso da zero.(Vedere la tabella seguente per il comportamento MoveFirst o una chiamata non riuscito MoveLast ).

  • Tutte le operazioni di spostamento eseguita mediante una causa record sia IsBOF che IsEOF per restituire 0.

  • Una chiamata AddNew seguita da una chiamata Aggiorna correttamente che consente di inserire un nuovo record viene IsBOF a restituire 0, ma solo se IsEOF è già diverso da zero.Lo stato IsEOF sempre rimarrà invariato.Come indicato dal modulo di gestione di database Microsoft Jet, il puntatore del record corrente di un recordset vuoto trova alla fine di un file, pertanto il nuovo record viene inserito dopo il record corrente.

  • Alcuna chiamata Elimina, anche se rimuove l'unico record rimanente da un recordset, non modifica il valore IsBOF o IsEOF.

In questa tabella vengono visualizzate le operazioni di spostamento vengono bloccate da diverse combinazioni IsBOF/IsEOF.

 

MoveFirst, MoveLast

MovePrev,

Spostamento < 0

Spostamento 0

MoveNext,

Spostamento > 0

=nonzero diIsBOF,

IsEOF=0

Consentito

Eccezione

Eccezione

Consentito

IsBOF=0,

=nonzero diIsEOF

Consentito

Consentito

Eccezione

Eccezione

Entrambi diversi da zero

Eccezione

Eccezione

Eccezione

Eccezione

Entrambe il 0

Consentito

Consentito

Consentito

Consentito

Consentire un'operazione di spostamento non significa che l'operazione correttamente inserire un record.Solo indica che un tentativo di eseguire l'operazione di spostamento specificata è consentito e non genererà un'eccezione.Il valore delle funzioni membro IsEOF e IsBOF può essere modificato come risultato di un movimento eseguito.

L'effetto di operazioni di spostamento non individua un record al valore IsBOF e le impostazioni IsEOF è illustrato nella tabella seguente.

 

IsBOF

IsEOF

MoveFirst, MoveLast

Diverso da zero

Diverso da zero

Sposta 0

Nessuna modifica

Nessuna modifica

MovePrev, Sposta < 0

Diverso da zero

Nessuna modifica

MoveNext, Sposta > 0

Nessuna modifica

Diverso da zero

Per informazioni correlate, vedere l'argomento ", il BOF proprietà di EOF" nella Guida di DAO.

Requisiti

Header: afxdao.h

Vedere anche

Riferimenti

Classe di CDaoRecordset

Grafico della gerarchia

CDaoRecordset::IsEOF