CDaoRecordset::IsEOF
Chiamare la funzione membro come si passa da un record a per sapere se è necessario oltre l'ultimo record del recordset.
BOOL IsEOF( ) const;
Valore restituito
Diverso da zero se il recordset non contiene record o se si scorre oltre l'ultimo record, in caso contrario 0.
Note
È anche possibile chiamare IsEOF per determinare se il recordset contiene i record o è vuoto.Subito dopo avere chiamato Apri, se il recordset non contiene record, IsEOF restituisce diverso da zero.Quando si apre un recordset con almeno un record, il primo record è restituisce 0 IsEOF e del record corrente.
Se l'ultimo record è il record corrente quando si chiama MoveNext, IsEOF restituirà un valore diverso da zero.Se IsEOF restituisce diverso da zero e chiamate MoveNext, viene generata un'eccezione.Se IsEOF 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 di una chiamata non riuscita MoveFirst ).
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