Metodi MoveFirst, MoveLast, MoveNext e MovePrevious (ADO)

Sposta al primo record, all'ultimo record, o al record successivo o precedente in un oggetto Recordset specificato e lo imposta come record corrente.

Sintassi

  
recordset.{MoveFirst | MoveLast | MoveNext | MovePrevious}  

Osservazioni

Usare il metodo MoveFirst per spostare la posizione del record corrente nel primo record dell'oggetto Recordset.

Usare il metodo MoveLast per spostare la posizione del record corrente nell'ultimo record dell'oggetto Recordset. L'oggetto Recordset deve supportare i segnalibri o lo spostamento del cursore indietro, in caso contrario, la chiamata al metodo genererà un errore.

Una chiamata a MoveFirst o MoveLast quando l'oggetto Recordset è vuoto (sia BOF che EOF sono True) genera un errore.

Usare il metodo MoveNext per spostare la posizione corrente di un record in avanti (verso la parte inferiore dell'oggetto Recordset). Se l'ultimo record è il record corrente e si chiama il metodo MoveNext, ADO imposta il record corrente sulla posizione successiva all'ultimo record nel Recordset (EOF è True). Un tentativo di spostamento in avanti quando la proprietà EOF è già True genera un errore.

In ADO 2.5 e versioni successive, quando l'oggetto Recordset è stato filtrato o ordinato e i dati del record corrente vengono modificati, la chiamata al metodo MoveNext sposta il cursore due record in avanti dal record corrente. Ciò è dovuto al fatto che quando il record corrente viene modificato, il record successivo diventa il nuovo record corrente. La chiamata a MoveNext dopo la modifica sposta il cursore in avanti di un record dal nuovo record corrente. Questo comportamento è diverso dal comportamento in ADO 2.1 e versioni precedenti. In queste versioni precedenti, la modifica dei dati di un record corrente nell'oggetto Recordset ordinato o filtrato non modifica la posizione del record corrente e MoveNext sposta il cursore sul record successivo immediatamente dopo il record corrente.

Usare il metodo MovePrevious per spostare la posizione corrente di un record in indietro (verso la parte superiore dell'oggetto Recordset). L'oggetto Recordset deve supportare i segnalibri o lo spostamento del cursore indietro, in caso contrario, la chiamata al metodo genererà un errore. Se il primo record è il record corrente e si chiama il metodo MovePrevious, ADO imposta il record corrente sulla posizione che precede il primo record nel Recordset (BOF è True). Un tentativo di spostamento all'indietro quando la proprietà BOF è già True genera un errore. Se l'oggetto Recordset non supporta i segnalibri o lo spostamento indietro del cursore, il metodo MovePrevious genererà un errore.

Se l'oggetto Recordset è in forward-only e si vuole supportare lo scorrimento avanti e indietro, è possibile usare la proprietà CacheSize per creare una cache di record che supporti lo spostamento indietro del cursore tramite il metodo Move. Poiché i record memorizzati nella cache vengono caricati in memoria, è consigliabile evitare la memorizzazione nella cache di più record di quelli necessari. È possibile chiamare il metodo MoveFirst in un oggetto Recordset forward-only. In questo modo il provider può eseguire di nuovo il comando che ha generato l'oggetto Recordset.

Si applica a

Oggetto Recordset (ADO)

Vedere anche

Esempio dei metodi MoveFirst, MoveLast, MoveNext e MovePrevious (VB)
Esempio dei metodi MoveFirst, MoveLast, MoveNext e MovePrevious (VBScript)
Esempio dei metodi MoveFirst, MoveLast, MoveNext e MovePrevious (VC++)
Metodo Move (ADO)
Metodi MoveFirst, MoveLast, MoveNext e MovePrevious (Servizi Desktop remoto)
Metodo MoveRecord (ADO)