Bagikan melalui


TextReader.ReadLine Metode

Definisi

Membaca baris karakter dari pembaca teks dan mengembalikan data sebagai string.

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

Mengembalikan

Baris berikutnya dari pembaca, atau null jika semua karakter telah dibaca.

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

Garis didefinisikan sebagai urutan karakter diikuti oleh pengembalian pengangkutan (0x000d), umpan baris (0x000a), pengembalian pengangkutan diikuti oleh umpan baris, Environment.NewLine, atau penanda akhir aliran. String yang dikembalikan tidak berisi pengembalian penghentian pengangkutan atau umpan baris. Nilai yang dikembalikan adalah null jika akhir aliran input telah tercapai.

Jika metode melemparkan pengecualian, posisi pembaca dalam yang mendasar OutOfMemoryExceptionStream dimajukan dengan jumlah karakter yang dapat dibaca metode, tetapi karakter yang sudah dibaca ke dalam buffer internal ReadLine dibuang. Karena posisi pembaca dalam aliran tidak dapat diubah, karakter yang sudah dibaca tidak dapat dipulihkan dan hanya dapat diakses dengan menginisialisasi ulang TextReader objek. 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 ReadLine metode , lihat StreamReader.ReadLine metode .

Berlaku untuk

Lihat juga