TextReader.ReadLine Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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 -> stringPublic Overridable Function ReadLine () As StringMengembalikan
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.
Sudah TextReader ditutup.
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 .
