Metode CopyRecord (ADO)

  • Artikel

Menyalin entitas yang diwakili oleh rekaman ke lokasi lain.

Sintaks

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

Parameter

Sumber
Pilihan. 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
Opsional. Nilai String yang berisi URL yang menentukan lokasi tempat Sumber akan disalin.

UserName
Opsional. Nilai String yang berisi ID pengguna yang, jika diperlukan, mengotorisasi akses ke Tujuan.

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

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

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

Tampilkan Nilai

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

Keterangan

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 Tujuan mengidentifikasi entitas yang ada (misalnya, file atau direktori), kecuali adCopyOverWrite ditentukan.

Penting

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

Catatan

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)