TextReader.ReadLine Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Sumber:

TextReader.cs

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

public:
 virtual System::String ^ ReadLine();

public virtual string? ReadLine ();

abstract member ReadLine : unit -> string
override this.ReadLine : unit -> string

Public Overridable Function ReadLine () As String

Mengembalikan

String

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

Pengecualian

IOException

Terjadi kesalahan I/O.

OutOfMemoryException

Memori tidak cukup untuk mengalokasikan buffer untuk string yang dikembalikan.

ObjectDisposedException

Sudah TextReader ditutup.

ArgumentOutOfRangeException

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 .

Lihat juga

• ReadLine()
• ReadLine()
• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File