Metodo Move (ADO)
Sposta la posizione del record corrente in un oggetto Recordset .
Sintassi
recordset.Move NumRecords, Start
Parametri
NumRecords
Espressione long che specifica il numero di record spostati dalla posizione del record corrente.
Start
Opzionale. Valore stringa di o Variant che restituisce un segnalibro. È anche possibile usare un valore bookmarkEnum.
Osservazioni
Il metodo Move è supportato in tutti gli oggetti Recordset .
Se l'argomento NumRecords è maggiore di zero, la posizione del record corrente viene spostata in avanti (verso la fine del recordset ). Se NumRecords è minore di zero, la posizione del record corrente viene spostata all'indietro (verso l'inizio dell'oggetto Recordset ).
Se la chiamata Move sposta la posizione corrente del record a un punto prima del primo record, 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 la chiamata Move sposta la posizione corrente del record a un punto successivo all'ultimo record, ADO imposta il record corrente sulla posizione dopo l'ultimo record dell'oggetto recordset ( EOF è True). Un tentativo di procedere quando la proprietà EOF è già True genera un errore.
La chiamata al metodo Move da un oggetto Record set vuoto genera un errore.
Se si passa l'argomento start, lo spostamento è relativo al record con questo segnalibro, presupponendo che l'oggetto Recordset supporti i segnalibri. Se non specificato, lo spostamento è relativo al record corrente.
Se si utilizza la proprietà CacheSize per memorizzare nella cache locale i record dal provider, passando un argomento NumRecords che sposta la posizione del record corrente al di fuori del gruppo corrente di record memorizzati nella cache forza ADO a recuperare un nuovo gruppo di record, a partire dal record di destinazione. La proprietà CacheSize determina le dimensioni del gruppo appena recuperato e il record di destinazione è il primo record recuperato.
Se l'oggetto Recordset è in avanti solo, un utente può comunque passare un NumRecords argomento minore di zero, purché la destinazione si trova all'interno del set corrente di record memorizzati nella cache. Se la chiamata Sposta sposta la posizione del record corrente in un record prima del primo record memorizzato nella cache, si verificherà un errore. È quindi possibile usare una cache di record che supporta lo scorrimento completo su un provider che supporta solo lo scorrimento in avanti. Poiché i record memorizzati nella cache vengono caricati in memoria, è consigliabile evitare di memorizzare nella cache più record di quanto necessario. Anche se un oggetto Recordset forward-only supporta gli spostamenti indietro in questo modo, la chiamata al metodo MovePrevious su qualsiasi oggetto Recordset forward-only genererà comunque un errore.
Nota
Il supporto per lo spostamento indietro in un recordset forward-only non è prevedibile, a seconda del provider. Se il record corrente è stato posizionato dopo l'ultimo record nell'oggetto Recordset , Sposta indietro potrebbe non generare la posizione corrente corretta.
Si applica a
Vedere anche
Esempio di metodo move (VB)
Esempio di metodo Move (VBScript)
Esempio di metodo Move (VC++)
metodi MoveFirst, MoveLast, MoveNext e MovePrevious (ADO)
metodi MoveFirst, MoveLast, MoveNext e MovePrevious (RDS)
metodo MoveRecord (ADO)