Share via


TextReader.ReadToEnd Metode

Definisi

Membaca semua karakter dari posisi saat ini ke akhir pembaca teks dan mengembalikannya sebagai satu string.

public:
 virtual System::String ^ ReadToEnd();
public virtual string ReadToEnd ();
abstract member ReadToEnd : unit -> string
override this.ReadToEnd : unit -> string
Public Overridable Function ReadToEnd () As String

Mengembalikan

String yang berisi semua karakter dari posisi saat ini ke akhir pembaca teks.

Pengecualian

Terjadi kesalahan I/O.

Memori tidak cukup untuk mengalokasikan buffer untuk string yang dikembalikan.

Jumlah karakter di baris berikutnya lebih besar dari Int32.MaxValue

Keterangan

Jika metode melemparkan pengecualian, posisi pembaca di yang mendasar OutOfMemoryExceptionStream dimajukan dengan jumlah karakter yang dapat dibaca metode, tetapi karakter yang sudah dibaca ke dalam buffer internal ReadToEnd akan dibuang. Karena posisi pembaca dalam aliran tidak dapat diubah, karakter yang sudah dibaca tidak dapat dipulihkan dan hanya dapat diakses dengan menginisialisasi TextReaderulang . Jika posisi awal dalam aliran tidak diketahui atau aliran tidak mendukung pencarian, yang mendasar Stream juga perlu diinisialisasi ulang.

Untuk menghindari situasi seperti itu dan menghasilkan kode yang kuat, Anda harus menggunakan Read metode dan menyimpan karakter baca dalam buffer yang telah dialokasikan sebelumnya.

Kelas TextReader ini adalah kelas abstrak. Oleh karena itu, Anda tidak membuat instans dalam kode Anda. Untuk contoh penggunaan ReadToEnd metode , lihat StreamReader.ReadToEnd metode .

Berlaku untuk

Lihat juga