Metode CopyRecord (ADO)

Menyalin entitas yang diwakili oleh rekaman ke lokasi lain.

Sintaksis

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

Parameter

Sumber
Fakultatif. Nilai String yang berisi URL yang menentukan entitas yang akan disalin (misalnya, file atau direktori). Jika Sumber dihilangkan atau menentukan string kosong, file atau direktori yang diwakili oleh Rekaman saat ini akan disalin.

Tujuan
Fakultatif. Nilai String yang berisi URL yang menentukan lokasi tempat Sumber akan disalin.

Nama Pengguna
Fakultatif. Nilai String yang berisi ID pengguna yang, jika diperlukan, mengotorisasi akses ke Tujuan.

Kata Sandi
Fakultatif. Nilai String yang berisi kata sandi yang, jika diperlukan, memverifikasi UserName.

Opsi
Fakultatif. Nilai CopyRecordOptionsEnum yang memiliki nilai default adCopyUnspecified . Menentukan perilaku metode ini.

asinkron
Fakultatif. Nilai Boolean yang, ketika True, menentukan bahwa operasi ini harus asinkron.

Mengembalikan Nilai

Nilai String yang biasanya mengembalikan nilai Tujuan. Namun, nilai pasti yang dikembalikan bergantung pada penyedia.

Komentar

Nilai Sumber dan Tujuan tidak boleh identik; jika tidak, kesalahan run-time terjadi. Setidaknya salah satu nama server, jalur, atau sumber daya harus berbeda.

Semua anak (misalnya, subdirektori) Sumber disalin secara rekursif, kecuali adCopyNonRecursive ditentukan. Dalam operasi rekursif, Tujuan tidak boleh menjadi subdirektori Sumber; jika tidak, operasi tidak akan selesai.

Metode ini gagal jika Destination mengidentifikasi entitas yang ada (misalnya, file atau direktori), kecuali adCopyOverWrite ditentukan.

Penting

Gunakan opsi adCopyOverWrite. Misalnya, menentukan opsi ini saat menyalin file ke direktori akan menghapus direktori dan menggantinya dengan file.

Nota

URL yang menggunakan skema http akan secara otomatis memanggil Penyedia Microsoft OLE DB untuk Penerbitan Internet. Untuk informasi selengkapnya, lihat URL Absolut dan Relatif .

Berlaku Untuk

Objek Rekaman (ADO)