Metode MoveRecord (ADO)
Memindahkan entitas yang diwakili oleh Rekaman ke lokasi lain.
Sintaks
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)
Parameter
Sumber
Pilihan. Nilai String yang berisi URL yang mengidentifikasi Rekaman yang akan dipindahkan. Jika Sumber dihilangkan atau menentukan string kosong, objek yang diwakili oleh Rekaman ini dipindahkan. Misalnya, jika Rekaman mewakili file, konten file dipindahkan ke lokasi yang ditentukan oleh Tujuan.
Tujuan
Opsional. Nilai String yang berisi URL yang menentukan lokasi tempat Sumber akan dipindahkan.
UserName
Opsional. Nilai String yang berisi ID pengguna yang, jika diperlukan, mengotorisasi akses ke Tujuan.
Kata sandi
Pilihan. String yang berisi kata sandi yang, jika diperlukan, memverifikasi UserName.
Opsi
Opsional. Nilai MoveRecordOptionsEnum yang nilai defaultnya adalah adMoveUnspecified. Menentukan perilaku metode ini.
Asinkron
Pilihan. Nilai Boolean yang, ketika True, menentukan operasi ini harus asinkron.
Tampilkan Nilai
Nilai String . Biasanya, nilai Tujuan dikembalikan. Namun, nilai pasti yang dikembalikan bergantung pada penyedia.
Keterangan
Nilai Sumber dan Tujuan tidak boleh identik; jika tidak, kesalahan run-time terjadi. Setidaknya nama server, jalur, dan sumber daya harus berbeda.
Untuk file yang dipindahkan menggunakan Penyedia Penerbitan Internet, metode ini memperbarui semua tautan hiperteks dalam file yang dipindahkan kecuali ditentukan lain oleh Opsi. Metode ini gagal jika Tujuan mengidentifikasi objek yang ada (misalnya, file atau direktori), kecuali adMoveOverWrite ditentukan.
Catatan
Gunakan opsi adMoveOverWrite secara yudikat. Misalnya, menentukan opsi ini saat memindahkan file ke direktori akan menghapus direktori dan menggantinya dengan file.
Atribut tertentu dari objek Rekam , seperti properti ParentURL , tidak akan diperbarui setelah operasi ini selesai. Refresh properti Objek rekaman dengan menutup Rekaman, lalu buka kembali dengan URL lokasi tempat file atau direktori dipindahkan.
Jika Rekaman ini diperoleh dari Recordset, lokasi baru file atau direktori yang dipindahkan tidak akan segera tercermin dalam Recordset. Refresh Recordset dengan menutup dan membukanya kembali.
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
Lihat juga
Metode Pemindahan (ADO)
MoveFirst, MoveLast, MoveNext, dan MovePrevious Methods (ADO)
Metode MoveFirst, MoveLast, MoveNext, dan MovePrevious (RDS)