Metode Terbuka (Aliran ADO)

  • Artikel

Membuka objek Stream untuk memanipulasi aliran data biner atau teks.

Sintaks

  
Stream.Open Source, Mode , OpenOptions, UserName, Password

Parameter

Sumber
Pilihan. Nilai Varian yang menentukan sumber data untuk Stream. Sumber mungkin berisi string URL absolut yang menunjuk ke simpul yang ada dalam struktur pohon terkenal, seperti email atau sistem file. URL harus ditentukan dengan menggunakan kata kunci URL ("URL=scheme://folderserver/"). Atau, Sumber mungkin berisi referensi ke objek Rekaman yang sudah terbuka, yang membuka aliran default yang terkait dengan Rekaman. Jika Sumber tidak ditentukan, Stream akan dibuat dan dibuka, dikaitkan tanpa sumber yang mendasar secara default. Untuk informasi selengkapnya tentang skema URL dan penyedia terkait, lihat URL Absolut dan Relatif.

Mode
Pilihan. Nilai ConnectModeEnum yang menentukan mode akses untuk Stream yang dihasilkan (misalnya, baca/tulis atau baca-saja). Nilai defaultnya adalah adModeUnknown. Lihat properti Mode untuk informasi selengkapnya tentang mode akses. Jika Mode tidak ditentukan, mode tersebut diwarisi oleh objek sumber. Misalnya, jika Rekaman sumber dibuka dalam mode baca-saja, Stream juga akan dibuka dalam mode baca-saja secara default.

OpenOptions
Pilihan. Nilai StreamOpenOptionsEnum . Nilai defaultnya adalah adOpenStreamUnspecified.

UserName
Opsional. Nilai String yang berisi identifikasi pengguna yang, jika diperlukan, mengakses objek Stream .

Kata sandi
Pilihan. Nilai String yang berisi kata sandi yang, jika diperlukan, mengakses objek Stream .

Keterangan

Saat objek Rekaman diteruskan sebagai parameter sumber, parameter UserID dan Kata Sandi tidak digunakan karena akses ke objek Rekaman sudah tersedia. Demikian pula, Mode objek Rekaman ditransfer ke objek Stream . Saat Sumber tidak ditentukan, Aliran yang dibuka tidak berisi data dan memiliki Ukuran nol (0). Untuk menghindari kehilangan data apa pun yang ditulis ke Stream ini saat Stream ditutup, simpan Stream dengan metode CopyTo atau SaveToFile , atau simpan ke lokasi memori lain.

Nilai OpenOptionsdari adOpenStreamFromRecord mengidentifikasi konten parameter Sumber menjadi objek Rekaman yang sudah terbuka. Perilaku default adalah memperlakukan Sumber sebagai URL yang menunjuk langsung ke simpul dalam struktur pohon, seperti file. Aliran default yang terkait dengan simpul tersebut dibuka.

Meskipun Stream tidak terbuka, dimungkinkan untuk membaca semua properti baca-saja dari Stream. Jika Stream dibuka secara asinkron, semua operasi berikutnya (selain memeriksa Status dan properti baca-saja lainnya) diblokir hingga operasi Buka selesai.

Selain opsi yang dibahas sebelumnya, dengan tidak menentukan Sumber, Anda dapat membuat instans objek Stream dalam memori tanpa mengaitkannya dengan sumber yang mendasar. Anda dapat secara dinamis menambahkan data ke aliran dengan menulis data biner atau teks ke Stream dengan Write atau WriteText, atau dengan memuat data dari file dengan LoadFromFile.

Berlaku Untuk

Objek Aliran (ADO)

Lihat juga

Metode Terbuka (Koneksi ADO)
Metode Terbuka (Catatan ADO)
Metode Terbuka (Recordset ADO)
Metode OpenSchema
Metode SaveToFile