Metodo CopyRecord (ADO)

  • Articolo

Copia un'entità rappresentata da un record in un'altra posizione.

Sintassi

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

Parametri

Origine
facoltativo. Valore String contenente un URL che specifica l'entità da copiare, ad esempio un file o una directory. Se si omette il parametro Source o si specifica una stringa vuota, verrà copiato il file o la directory rappresentata dall'oggetto Record corrente.

Destinazione
facoltativo. Valore String contenente un URL che specifica la posizione in cui verrà copiato 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 di CopyRecordOptionsEnum il cui valore predefinito è adCopyUnspecified. Specifica il comportamento di questo metodo.

Asincrona
facoltativo. Valore booleano che, quando è True, specifica che questa operazione deve essere asincrona.

Valore restituito

Valore String che in genere restituisce 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 uno dei nomi di server, percorso o risorsa deve essere diverso.

Tutti i gli elementi figlio, ad esempio le sottodirectory, di Source vengono copiati in modo ricorsivo, a meno che non sia specificato adCopyNonRecursive. In un'operazione ricorsiva, Destination non deve essere una sottodirectory di Source. In caso contrario, l'operazione non verrà completata.

Questo metodo non riesce negativo se Destination identifica un'entità esistente, ad esempio un file o una directory, a meno che non venga specificato adCopyOverWrite.

Importante

Usare l'opzione adCopyOverWrite in modo oculato. Ad esempio, specificando questa opzione durante la copia di un file in una directory, la directory verrà eliminata e sostituita con il file.

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)