Metode ReadText

Membaca jumlah karakter yang ditentukan dari teks objek Stream.

Sintaksis

  
String = Stream.ReadText ( NumChars)  

Parameter

NumChars
Fakultatif. Nilai Panjang yang menentukan jumlah karakter yang akan dibaca dari file, atau nilai StreamReadEnum. Nilai defaultnya adalah adReadAll.

Mengembalikan Nilai

Metode ReadText membaca jumlah karakter tertentu, seluruh baris, atau seluruh aliran dari objek Stream dan mengembalikan string yang dihasilkan.

Komentar

Jika NumChar lebih dari jumlah karakter yang tersisa di aliran, hanya karakter yang tersisa yang dikembalikan. String yang dibaca tidak diisi agar sesuai dengan panjang yang ditentukan oleh NumChar. Jika tidak ada karakter yang tersisa untuk dibaca, varian yang nilainya null dikembalikan. ReadText tidak dapat digunakan untuk membaca mundur.

Nota

Metode ReadText digunakan dengan aliran teks (JenisadTypeText ). Untuk aliran biner (JenisadTypeBinary), gunakan Read.

Kueri yang mengakibatkan sejumlah besar data XML dikembalikan melalui metode ReadText objek Aliran Objek Data ActiveX (ADO) mungkin membutuhkan banyak waktu untuk dijalankan; jika ini dilakukan dalam komponen COM+ yang dipanggil dari halaman ASP, sesi pengguna mungkin kehabisan waktu. ADO mengonversi data objek Stream dari pengodean UTF-8 ke Unicode; realokasi memori yang sering terlibat dalam konversi sejumlah besar data sekaligus cukup memakan waktu. Untuk mengatasinya, lakukan panggilan berulang ke metode ReadText dari objek perintah ADO, dan tentukan jumlah karakter yang lebih kecil. Pengujian telah menunjukkan bahwa nilai yang setara dengan 128K (131.072) optimal. Waktu respons menurun karena nilai ini menurun. Untuk informasi selengkapnya, lihat artikel Pangkalan Pengetahuan 280067, "PRB: Mengambil Dokumen XML yang sangat besar dari SQL Server 2000 dengan menggunakan metode ReadText objek aliran ADO mungkin lambat", di Pangkalan Pengetahuan Microsoft di https://support.microsoft.com.

Berlaku Untuk

Stream Object (ADO)

Lihat Juga

Metode Baca