TextReader.Read Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestawy:

netstandard.dll, System.Runtime.dll

Odczytuje dane z czytnika tekstu.

Przeciążenia

Nazwa	Opis
Read()	Odczytuje następny znak z czytnika tekstu i rozwija położenie 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 położenie 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ępuje błąd we/wy.

Uwagi

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

Zobacz też

• Read()
• Read()
• Wejście/Wyjście plików i strumieni
• 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 zwraca, zawiera określony zakres znaków zastąpiony przez znaki odczytane z bieżącego źródła.

Zwraca

Int32

Liczba odczytanych znaków. 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

Parametr buffer ma wartość null.

IOException

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

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 odczytanymi z bieżącego źródła.

index

Int32

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

count

Int32

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

Zwraca

Int32

Liczba odczytanych znaków. 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

Parametr buffer ma wartość 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ępuje 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 abstrakcyjną klasą. W związku z tym nie tworzy się ich 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)
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku