Metodi MoveFirst, MoveLast, MoveNext e MovePrevious (ADO)
Passa al primo, ultimo, successivo o precedente record in un oggetto Recordset specificato oggetto e imposta il record corrente.
Sintassi
recordset.{MoveFirst | MoveLast | MoveNext | MovePrevious}
Osservazioni
Utilizzare il metodo MoveFirst per spostare la posizione del record corrente nel primo record dell'oggetto Recordset .
Utilizzare 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 indietro del cursore; in caso contrario, la chiamata al metodo genererà un errore.
Una chiamata a MoveFirst o MoveLast quando la Recordset di è vuota (sia BOF che EOF sono True) genera un errore.
Utilizzare il metodo MoveNext per spostare la posizione corrente di un record in avanti (verso la fine del recordset ). Se l'ultimo record è il record corrente e si chiama il metodo MoveNext, ADO imposta il record corrente sulla posizione dopo l'ultimo record nell'Recordset (EOF è True). Un tentativo di procedere quando la proprietà EOF è già True genera un errore.
In ADO 2.5 e versioni successive, quando il Recordset è stato filtrato o ordinato e i dati del record corrente vengono modificati, chiamando il 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. Chiamando MoveNext dopo che 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.
Utilizzare il metodo MovePrevious per spostare la posizione corrente di un record all'indietro (verso la parte superiore del recordset ). L'oggetto recordset deve supportare i segnalibri o lo spostamento indietro del cursore; 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 prima del primo record nel Recordset (bof è True). Tentativo di spostamento 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 la recordset è solo in avanti e si desidera supportare lo scorrimento avanti e indietro, è possibile utilizzare 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 di memorizzare nella cache più record di quanto necessario. È possibile chiamare il metodo MoveFirst in un oggetto Recordset forward-only; in questo modo il provider può eseguire nuovamente il comando che ha generato l'oggetto Recordset .
Si applica a
Vedere anche
metodi MoveFirst, MoveLast, MoveNext e MovePrevious (VB)
metodi MoveFirst, MoveLast, MoveNext e MovePrevious (VBScript)
metodi MoveFirst, MoveLast, MoveNext e MovePrevious (VC++)
metodo move (ADO)
metodi MoveFirst, MoveLast, MoveNext e MovePrevious (RDS)
metodo MoveRecord (ADO)