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