TextReader.Read Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

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

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

Int32

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

Wyjątki

ObjectDisposedException

Element TextReader jest zamknięty.

IOException

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ż

• Read()
• Read()
• Plik i Stream we/wy
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku

Read(Span<Char>)

Ź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

Int32

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

ArgumentNullException

buffer to null.

IOException

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

Read(Char[], Int32, Int32)

Ź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

Int32

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

ArgumentNullException

buffer to null.

ArgumentException

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

ArgumentOutOfRangeException

index lub count jest ujemny.

ObjectDisposedException

Element TextReader jest zamknięty.

IOException

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ż

• Read(Char[], Int32, Int32)
• Read(Char[], Int32, Int32)
• Plik i Stream we/wy
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku