TextReader.Read Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Membaca data dari pembaca teks.

Overload

Read()	Membaca karakter berikutnya dari pembaca teks dan memajukan posisi karakter dengan satu karakter.
Read(Span<Char>)	Membaca karakter dari pembaca saat ini dan menulis data ke buffer yang ditentukan.
Read(Char[], Int32, Int32)	Membaca jumlah karakter maksimum yang ditentukan dari pembaca saat ini dan menulis data ke buffer, dimulai pada indeks yang ditentukan.

Read()

Sumber:

TextReader.cs

Membaca karakter berikutnya dari pembaca teks dan memajukan posisi karakter dengan satu karakter.

public:
 virtual int Read();

public virtual int Read ();

abstract member Read : unit -> int
override this.Read : unit -> int

Public Overridable Function Read () As Integer

Mengembalikan

Int32

Karakter berikutnya dari pembaca teks, atau -1 jika tidak ada lagi karakter yang tersedia. Implementasi default mengembalikan -1.

Pengecualian

ObjectDisposedException

Sudah TextReader ditutup.

IOException

Terjadi kesalahan I/O.

Keterangan

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

Lihat juga

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

Read(Span<Char>)

Sumber:

TextReader.cs

Membaca karakter dari pembaca saat ini dan menulis data ke buffer yang ditentukan.

public:
 virtual int Read(Span<char> buffer);

public virtual int Read (Span<char> buffer);

abstract member Read : Span<char> -> int
override this.Read : Span<char> -> int

Public Overridable Function Read (buffer As Span(Of Char)) As Integer

Parameter

buffer

Span<Char>

Ketika metode ini kembali, berisi rentang karakter yang ditentukan yang digantikan oleh karakter yang dibaca dari sumber saat ini.

Mengembalikan

Int32

Jumlah karakter yang telah dibaca. Jumlahnya akan kurang dari atau sama dengan panjangnya buffer , tergantung pada apakah data tersedia dalam pembaca. Metode ini mengembalikan 0 (nol) jika dipanggil ketika tidak ada lagi karakter yang dibiarkan dibaca.

Pengecualian

ArgumentNullException

bufferadalah null.

IOException

Jumlah karakter yang dibaca dari aliran lebih besar dari panjang buffer.

Read(Char[], Int32, Int32)

Sumber:

TextReader.cs

Membaca jumlah karakter maksimum yang ditentukan dari pembaca saat ini dan menulis data ke buffer, dimulai pada indeks yang ditentukan.

public:
 virtual int Read(cli::array <char> ^ buffer, int index, int count);

public virtual int Read (char[] buffer, int index, int count);

abstract member Read : char[] * int * int -> int
override this.Read : char[] * int * int -> int

Public Overridable Function Read (buffer As Char(), index As Integer, count As Integer) As Integer

Parameter

buffer

Char[]

Ketika metode ini kembali, berisi array karakter yang ditentukan dengan nilai antara index dan (index + count - 1) digantikan oleh karakter yang dibaca dari sumber saat ini.

index

Int32

Posisi untuk buffer mulai menulis.

count

Int32

Jumlah maksimum karakter yang akan dibaca. Jika akhir pembaca tercapai sebelum jumlah karakter yang ditentukan dibaca ke dalam buffer, metode akan kembali.

Mengembalikan

Int32

Jumlah karakter yang telah dibaca. Jumlahnya akan kurang dari atau sama dengan count, tergantung pada apakah data tersedia dalam pembaca. Metode ini mengembalikan 0 (nol) jika dipanggil ketika tidak ada lagi karakter yang dibiarkan dibaca.

Pengecualian

ArgumentNullException

bufferadalah null.

ArgumentException

Panjang buffer minus index kurang dari count.

ArgumentOutOfRangeException

index atau count negatif.

ObjectDisposedException

Sudah TextReader ditutup.

IOException

Terjadi kesalahan I/O.

Keterangan

Metode ini kembali setelah salah satu count karakter dibaca atau akhir file tercapai. ReadBlock adalah versi pemblokiran dari metode ini.

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

Lihat juga

• Read(Char[], Int32, Int32)
• Read(Char[], Int32, Int32)
• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File