Metodo MoveRecord (ADO)
Sposta l'entità rappresentata da un Record in un'altra posizione.
Sintassi
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)
Parametri
origine
Opzionale. Valore string che contiene un URL che identifica l'record da spostare. Se origine viene omessa o specifica una stringa vuota, l'oggetto rappresentato da questo record viene spostato. Ad esempio, se l'record rappresenta un file, il contenuto del file viene spostato nel percorso specificato da Destinazione.
di destinazione
Opzionale. Valore string contenente un URL che specifica il percorso in cui verrà spostato origine.
UserName
Opzionale. Valore string che contiene l'ID utente che, se necessario, autorizza l'accesso a Destinazione.
password
Opzionale. Un string contenente la password che, se necessario, verifica UserName.
Opzioni
Opzionale. Valore MoveRecordOptionsEnum il cui valore predefinito è adMoveUnspecified. Specifica il comportamento di questo metodo.
asincrona
Opzionale. Valore booleano che, quando True, specifica che questa operazione deve essere asincrona.
Valore restituito
Valore string. In genere, viene restituito il valore di Destination. Tuttavia, il valore esatto restituito è dipendente dal provider.
Osservazioni
I valori di origine e destinazione non devono essere identici; in caso contrario, si verifica un errore di run-time. Almeno il server, il percorso e i nomi delle risorse devono essere diversi.
Per i file spostati tramite il provider di pubblicazione Internet, questo metodo aggiorna tutti i collegamenti ipertestuali nei file spostati, a meno che non diversamente specificato da opzioni di . Questo metodo ha esito negativo se Destination identifica un oggetto esistente (ad esempio, un file o una directory), a meno che non venga specificato adMoveOverWrite.
Nota
Usare l'opzione adMoveOverWrite in modo succoso. Ad esempio, se si specifica questa opzione quando si sposta un file in una directory, la directory verrà eliminata e sostituita con il file .
Alcuni attributi dell'oggetto record, ad esempio la proprietà ParentURL, non verranno aggiornati al termine dell'operazione. Aggiornare le proprietà dell'oggetto record chiudendo l'Record, quindi riandondo con l'URL del percorso in cui è stato spostato il file o la directory.
Se questo Record è stato ottenuto da un oggetto Recordset , la nuova posizione del file o della directory spostata non verrà riflessa immediatamente nell'oggetto Recordset . Aggiornare il recordset chiudendolo e riandondo.
Nota
Gli URL che usano lo schema HTTP richiamano automaticamente il provider Microsoft OLE DB per Internet Publishing. Per altre informazioni, vedere URL assoluti e relativi.
Si applica a
Vedere anche
metodo move (ADO)
metodi MoveFirst, MoveLast, MoveNext e MovePrevious (ADO)
metodi MoveFirst, MoveLast, MoveNext e MovePrevious (RDS)