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 akhir input pembaca. String yang dikembalikan tidak berisi penghentian pengembalian pengangkutan atau umpan baris. Nilai yang dikembalikan adalah null jika akhir input telah tercapai.
Jika input berakhir dengan urutan baris baru, tidak ada baris kosong tambahan yang dikembalikan. Misalnya, input yang berisi "line1\nline2\n" menghasilkan dua baris yang sama ("line1" dan "line2") sebagai input yang berisi "line1\nline2".
Jika metode melemparkan pengecualian, posisi pembaca di sumber yang mendasar OutOfMemoryException dimajukan oleh jumlah karakter yang dapat dibaca metode, tetapi karakter yang sudah dibaca ke dalam buffer internal ReadLine dibuang. Karena posisi pembaca di sumber yang mendasar tidak dapat direset, karakter yang sudah dibaca tidak dapat dipulihkan dan hanya dapat diakses dengan menginisialisasi ulang TextReader objek. Jika posisi awal dalam sumber yang mendasar tidak diketahui atau sumber tidak mendukung reposisi, sumber yang mendasar 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 metode , ReadLine lihat StreamReader.ReadLine metode .
