Proprietà BOF ed EOF (ADO)

  • Articolo

  • BOF Indica che la posizione del record corrente è precedente al primo record in un oggetto Recordset.

  • EOF Indica che la posizione del record corrente è successiva all’ultimo record in un oggetto Recordset.

Valore restituito

Le proprietà BOF ed EOF restituiscono valori booleani.

Osservazioni

Utilizzare le proprietà BOF ed EOF per determinare se un oggetto Recordset contiene record o se sono stati superati i limiti di un oggetto Recordset quando si passa da un record all’altro.

La proprietà BOF restituisce True (-1) se la posizione del record corrente è precedente al primo record e False (0) se la posizione del record corrente è sul primo record o dopo.

La proprietà EOF restituisce True se la posizione del record corrente è successiva all’ultimo record e False se la posizione del record corrente è sull’ultimo record o prima.

Se la proprietà BOF o EOF è True, non è presente alcun record corrente.

Se si apre un oggetto Recordset che non contiene record, le proprietà BOF ed EOF sono impostate su True. Per ulteriori informazioni su questo stato di un Recordset, vedere la proprietà RecordCount. Quando si apre un oggetto Recordset contenente almeno un record, il primo record è il record corrente e le proprietà BOF ed EOF sono False.

Se si elimina l'ultimo record rimanente nell'oggetto Recordset, le proprietà BOF ed EOF potrebbero rimanere False fino a quando non si tenta di riposizionare il record corrente.

Questa tabella mostra i metodi Move consentiti con combinazioni diverse delle proprietà BOF ed EOF.

MoveFirst,

MoveLast		 MovePrevious,

Move < 0		 Move 0 MoveNext,

Move > 0
BOF=True, EOF=False Consentito Errore Errore Consentito
BOF=False, EOF=True Consentito Consentito Errore Errore
Entrambe True Errore Errore Errore Errore
Entrambe False Consentito Consentito Consentito Consentito

Il fatto che un metodo Move sia consentito non garantisce che il metodo individua correttamente un record; significa solo che la chiamata al metodo Move specificato non genererà un errore.

La tabella seguente illustra cosa accade alle impostazioni delle proprietà BOF ed EOF quando si chiamano vari metodi Move ma si riesce a individuare correttamente un record.

BOF EOF
MoveFirst, MoveLast Impostato su True Impostato su True
Move 0 Nessuna modifica Nessuna modifica
MovePrevious, Move< 0 Impostata su True Nessuna modifica
MoveNext, Move> 0 Nessuna modifica Impostata su True

Si applica a

Oggetto Recordset (ADO)

Vedere anche

Esempio delle proprietà BOF, EOF e Bookmark (VB)
Esempio delle proprietà BOF, EOF e Bookmark(VC++)