Metode CopyTo (ADO)

Menyalin jumlah karakter atau byte yang ditentukan (tergantung pada Jenis) di Aliran ke objek Stream lain.

Sintaks

  
Stream.CopyTo DestStream, NumChars  

Parameter

DestStream
Nilai variabel objek yang berisi referensi ke objek Stream terbuka. Aliran saat ini disalin ke Aliran tujuan yang ditentukan oleh DestStream. Stream tujuan harus sudah terbuka. Jika tidak, kesalahan run-time terjadi.

Catatan

Parameter DestStream mungkin bukan proksi objek Stream karena ini memerlukan akses ke antarmuka privat pada objek Stream yang tidak dapat di-remote ke klien.

NumChars
Pilihan. Nilai Bilangan bulat yang menentukan jumlah byte atau karakter yang akan disalin dari posisi saat ini di Aliran sumber ke Aliran tujuan. Nilai defaultnya adalah -1, yang menentukan bahwa semua karakter atau byte disalin dari posisi saat ini ke EOS.

Keterangan

Metode ini menyalin jumlah karakter atau byte yang ditentukan, dimulai dari posisi saat ini yang ditentukan oleh properti Posisi . Jika angka yang ditentukan lebih dari jumlah byte yang tersedia hingga EOS, maka hanya karakter atau byte dari posisi saat ini ke EOS yang disalin. Jika nilai NumChars adalah -1, atau dihilangkan, semua karakter atau byte yang dimulai dari posisi saat ini akan disalin.

Jika ada karakter atau byte yang ada di aliran tujuan, semua konten di luar titik di mana salinan berakhir tetap, dan tidak terpotong. Posisi menjadi byte segera setelah byte terakhir disalin. Jika Anda ingin memotong byte ini, panggil SetEOS.

CopyTo harus digunakan untuk menyalin data ke Stream tujuan dengan jenis yang sama dengan Aliran sumber (pengaturan properti Jenis mereka adalah adTypeText atau kedua adTypeBinary). Untuk objek Stream teks, Anda dapat mengubah pengaturan properti Charset dari Stream tujuan untuk diterjemahkan dari satu karakter yang diatur ke karakter lainnya. Selain itu, objek Aliran teks dapat berhasil disalin ke objek Stream biner, tetapi objek Stream biner tidak dapat disalin ke dalam objek Aliran teks.

Berlaku Untuk

Objek Aliran (ADO)