Udostępnij za pośrednictwem


TextReader.Read Metoda

Definicja

Odczytuje dane z czytnika tekstu.

Przeciążenia

Read()

Odczytuje następny znak z czytnika tekstu i rozwija pozycję znaku o jeden znak.

Read(Span<Char>)

Odczytuje znaki z bieżącego czytnika i zapisuje dane w określonym buforze.

Read(Char[], Int32, Int32)

Odczytuje określoną maksymalną liczbę znaków z bieżącego czytnika i zapisuje dane w buforze, zaczynając od określonego indeksu.

Read()

Źródło:
TextReader.cs
Źródło:
TextReader.cs
Źródło:
TextReader.cs

Odczytuje następny znak z czytnika tekstu i rozwija pozycję znaku o jeden znak.

public:
 virtual int Read();
public virtual int Read ();
abstract member Read : unit -> int
override this.Read : unit -> int
Public Overridable Function Read () As Integer

Zwraca

Następny znak z czytnika tekstu lub -1, jeśli nie są dostępne żadne znaki. Domyślna implementacja zwraca wartość -1.

Wyjątki

Element TextReader jest zamknięty.

Wystąpi błąd We/Wy.

Uwagi

Klasa TextReader jest klasą abstrakcyjną. W związku z tym, nie tworzy się obiektu w kodzie. Aby zapoznać się z przykładem użycia Read metody, zobacz metodę StreamReader.Read .

Zobacz też

Dotyczy

Read(Span<Char>)

Źródło:
TextReader.cs
Źródło:
TextReader.cs
Źródło:
TextReader.cs

Odczytuje znaki z bieżącego czytnika i zapisuje dane w określonym buforze.

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

Parametry

buffer
Span<Char>

Gdy ta metoda zostanie zwrócona, zawiera określony zakres znaków zastąpiony przez znaki odczytywane z bieżącego źródła.

Zwraca

Liczba znaków, które zostały odczytane. Liczba będzie mniejsza lub równa buffer długości, w zależności od tego, czy dane są dostępne w czytniku. Ta metoda zwraca wartość 0 (zero), jeśli jest wywoływana, gdy nie ma więcej znaków do odczytania.

Wyjątki

buffer to null.

Liczba znaków odczytywanych ze strumienia jest większa niż długość bufferelementu .

Dotyczy

Read(Char[], Int32, Int32)

Źródło:
TextReader.cs
Źródło:
TextReader.cs
Źródło:
TextReader.cs

Odczytuje określoną maksymalną liczbę znaków z bieżącego czytnika i zapisuje dane w buforze, zaczynając od określonego indeksu.

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

Parametry

buffer
Char[]

Gdy ta metoda zwraca, zawiera określoną tablicę znaków z wartościami między index i (index + count - 1) zastąpionymi znakami odczytywanymi z bieżącego źródła.

index
Int32

Pozycja, w buffer której rozpocząć pisanie.

count
Int32

Maksymalna liczba znaków do odczytania. Jeśli koniec czytnika zostanie osiągnięty przed odczytem określonej liczby znaków do buforu, metoda zwróci wartość .

Zwraca

Liczba znaków, które zostały odczytane. Liczba będzie mniejsza lub równa count, w zależności od tego, czy dane są dostępne w czytniku. Ta metoda zwraca wartość 0 (zero), jeśli jest wywoływana, gdy nie ma więcej znaków do odczytania.

Wyjątki

buffer to null.

Długość buforu minus index jest mniejsza niż count.

index lub count jest ujemny.

Element TextReader jest zamknięty.

Wystąpi błąd We/Wy.

Uwagi

Ta metoda zwraca wartość po count odczytaniu znaków lub osiągnięciu końca pliku. ReadBlock jest zablokowaną wersją tej metody.

Klasa TextReader jest klasą abstrakcyjną. W związku z tym, nie tworzy się obiektu w kodzie. Aby zapoznać się z przykładem użycia Read metody, zobacz metodę StreamReader.Read .

Zobacz też

Dotyczy