Bagikan melalui


TextReader.Read Metode

Definisi

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
Sumber:
TextReader.cs
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

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

Pengecualian

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

Berlaku untuk

Read(Span<Char>)

Sumber:
TextReader.cs
Sumber:
TextReader.cs
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

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

bufferadalah null.

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

Berlaku untuk

Read(Char[], Int32, Int32)

Sumber:
TextReader.cs
Sumber:
TextReader.cs
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

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

bufferadalah null.

Panjang buffer minus index kurang dari count.

index atau count negatif.

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

Berlaku untuk