Condividi tramite


Metodo MoveRecord (ADO)

Sposta l'entità rappresentata da un oggetto Record in un'altra posizione.

Sintassi

  
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)  

Parametri

Origine
facoltativo. Valore String contenente un URL che identifica l'oggetto Record da spostare. Se Source viene omesso o specifica una stringa vuota, l'oggetto rappresentato da questo oggetto Record viene spostato. Ad esempio, se l'oggetto Record rappresenta un file, il contenuto del file viene spostato nel percorso specificato da Destination.

Destinazione
facoltativo. Valore String contenente un URL che specifica la posizione in cui verrà spostato l'oggetto Source.

UserName
facoltativo. Valore String contenente l'ID utente che, se necessario, autorizza l'accesso a Destination.

Password
facoltativo. Valore String contenente la password che, se necessario, verifica UserName.

Opzioni
facoltativo. Valore MoveRecordOptionsEnum il cui valore predefinito è adMoveUnspecified. Specifica il comportamento di questo metodo.

Asincrona
facoltativo. 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, l'esatto valore restituito dipende dal provider.

Osservazioni

I valori di Source e Destination non devono essere identici. In caso contrario, si verifica un errore di runtime. Almeno i nomi di server, percorso o risorsa devono essere diversi.

Per i file spostati usando il provider di Internet Publishing, questo metodo aggiorna tutti i collegamenti ipertestuali nei file da spostare, se non diversamente specificato da Options. Questo metodo non riesce 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 oculato. Ad esempio, specificando questa opzione durante lo spostamento di 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'oggetto Record e quindi aprendolo nuovamente con l'URL del percorso in cui è stato spostato il file o la directory.

Se questo oggetto Record è stato ottenuto da un oggetto Recordset, il nuovo percorso del file o della directory spostata non sarà immediatamente visibile nell'oggetto Recordset. Per aggiornare l'oggetto Recordset, chiuderlo e riaprirlo.

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

Oggetto Record (ADO)

Vedere anche

Metodo Move (ADO)
Metodi MoveFirst, MoveLast, MoveNext e MovePrevious (ADO)
Metodi MoveFirst, MoveLast, MoveNext e MovePrevious (Servizi Desktop remoto)