Proprietà BOF ed EOF (ADO)
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
Vedere anche
Esempio delle proprietà BOF, EOF e Bookmark (VB)
Esempio delle proprietà BOF, EOF e Bookmark(VC++)