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 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, począwszy od określonego indeksu.

Read()

Source:

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 więcej znaków nie jest dostępnych. 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 abstrakcyjną klasą. 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()
• We/Wy pliku i strumienia
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku

Read(Span<Char>)

Source:

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 wartość , zawiera określony zakres znaków zamienione 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

buffer to null.

IOException

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

Read(Char[], Int32, Int32)

Source:

TextReader.cs

Odczytuje określoną maksymalną liczbę znaków z bieżącego czytnika i zapisuje dane w buforze, począwszy 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 wartość , 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 osiągnięto koniec czytnika, zanim określona liczba znaków zostanie odczytana 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

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 abstrakcyjną klasą. 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)
• We/Wy pliku i strumienia
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku