CDaoRecordset::IsEOF

BOOL IsEOF () const;
tiro (CDaoException, CMemoryException);

Valore restituito

Diverso da zero se il recordset non contiene nessun record o se hanno scorrere oltre l'ultimo record; in caso contrario 0.

Osservazioni

Chiamare questa funzione membro come voi scorrere da record per record a imparare se sono andati oltre l'ultimo record del recordset. È inoltre possibile chiamare IsEOF per determinare se il recordset contiene tutti i record o è vuoto. Immediatamente dopo la chiamata aperta, se il recordset non contiene nessun record, IsEOF restituisce diverso da zero. Quando si apre un recordset che ha almeno un record, il primo record è il record corrente e IsEOF restituisce 0.

Se l'ultimo record è il record corrente quando si chiama il metodo MoveNext, IsEOF successivamente verrà restituito diverso da zero. Se IsEOF restituisce diverso da zero e si chiama MoveNext, viene generata un'eccezione. Se IsEOF restituisce diverso da zero, il record corrente è indefinito e qualsiasi azione che richiede un record corrente genererà un'eccezione.

Effetto di metodi specifici sulle impostazioni IsBOF e IsEOF:

Internamente la chiamata aperta rende il primo record del recordset del record corrente chiamando MoveFirst. Pertanto, la chiamata aperta su un set vuoto di record determina IsBOF e IsEOF restituire diverso da zero. (Vedere la tabella seguente per il comportamento di una chiamata MoveFirst fallito.)
Tutte le operazioni di spostamento che individuare con successo un record causano IsBOF e IsEOF restituire 0.
Una chiamata di metodo AddNew , seguita da una chiamata di aggiornamento che consente di inserire con successo un nuovo record causerà IsBOF restituire 0, ma solo se IsEOF già è diverso da zero. Lo stato di IsEOF sempre rimarranno invariato. Come definito dal motore di database Microsoft Jet, il puntatore del record corrente di un oggetto recordset vuoto è alla fine di un file, in modo che qualsiasi nuovo record è inserito dopo il record corrente.
Qualsiasi chiamata a eliminare , anche se rimuove il record rimanente solo da un recordset, non cambia il valore della IsBOF o IsEOF.

Questa tabella mostra le operazioni di spostamento sono consentite con diverse combinazioni di IsBOF/IsEOF.

	MoveFirst, MoveLast	MovePrev, Spostare < 0	Spostare 0	MoveNext, Spostare > 0
IsBOF= diverso da zero, IsEOF= 0	Consentito	Eccezione	Eccezione	Consentito
IsBOF= 0, IsEOF= diverso da zero	Consentito	Consentito	Eccezione	Eccezione
Sia diverso da zero	Eccezione	Eccezione	Eccezione	Eccezione
Entrambi 0	Consentito	Consentito	Consentito	Consentito

Permettendo un'operazione di spostamento non significa che l'operazione localizzerà con successo un record. Esso indica semplicemente che un tentativo di eseguire l'operazione di spostamento specificato è consentito e non genererà un'eccezione. Il valore delle funzioni membro IsBOF e IsEOF possa cambiare di conseguenza la mossa tentata.

L'effetto di spostare le operazioni che non individuare un record sul valore delle impostazioni IsBOF e IsEOF è mostrato nella tabella seguente.

	IsBOF	IsEOF
MoveFirst, MoveLast	Diverso da zero	Diverso da zero
Spostare 0	Nessun cambiamento	Nessun cambiamento
MovePrev, spostare < 0	Diverso da zero	Nessun cambiamento
MoveNext, spostare > 0	Nessun cambiamento	Diverso da zero

Per ulteriori informazioni sulla navigazione nei recordset, vedere l'articolo Recordset DAO: navigazione Recordset nel manuale del programmatore di Visual C++. Per informazioni correlate, vedere l'argomento "BOF, proprietà EOF" nella guida di DAO.

Pa&noramica CDaoRecordset |nbsp; Membri della classe | Gerarchia Chart

Vedere a&nchenbsp;CDaoRecordset::IsBOF

Index