TextReader.ReadBlock Metoda

Definicja

Przeciążenia

ReadBlock(Span<Char>)

Odczytuje znaki z bieżącego strumienia i zapisuje dane w buforze.Reads the characters from the current stream and writes the data to a buffer.

ReadBlock(Char[], Int32, Int32)

Odczytuje określoną maksymalną liczbę znaków z bieżącego czytnika tekstu i zapisuje dane w buforze, rozpoczynając od określonego indeksu.Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.

ReadBlock(Span<Char>)

Odczytuje znaki z bieżącego strumienia i zapisuje dane w buforze.Reads the characters from the current stream and writes the data to a buffer.

public:
 virtual int ReadBlock(Span<char> buffer);
public virtual int ReadBlock (Span<char> buffer);
abstract member ReadBlock : Span<char> -> int
override this.ReadBlock : Span<char> -> int
Public Overridable Function ReadBlock (buffer As Span(Of Char)) As Integer

Parametry

buffer
Span<Char>

Gdy ta metoda zwraca, zawiera określony zakres znaków zastępowanych przez znaki odczytane z bieżącego źródła.When this method returns, contains the specified span of characters replaced by the characters read from the current source.

Zwraca

Int32

Liczba znaków, które zostały odczytane.The number of characters that have been read. Liczba jest mniejsza lub równa buffer długości, w zależności od tego, czy wszystkie znaki wejściowe zostały odczytane.The number will be less than or equal to the buffer length, depending on whether all input characters have been read.

Wyjątki

buffer to null.buffer is null.

StreamReaderJest zamknięty.The StreamReader is closed.

Wystąpił błąd we/wy.An I/O error occurred.

Dotyczy

ReadBlock(Char[], Int32, Int32)

Odczytuje określoną maksymalną liczbę znaków z bieżącego czytnika tekstu i zapisuje dane w buforze, rozpoczynając od określonego indeksu.Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.

public:
 virtual int ReadBlock(cli::array <char> ^ buffer, int index, int count);
public virtual int ReadBlock (char[] buffer, int index, int count);
abstract member ReadBlock : char[] * int * int -> int
override this.ReadBlock : char[] * int * int -> int
Public Overridable Function ReadBlock (buffer As Char(), index As Integer, count As Integer) As Integer

Parametry

buffer
Char[]

Gdy ta metoda zwraca, ten parametr zawiera określoną tablicę znaków z wartościami między index i ( index + count -1) zastąpione przez znaki odczytane z bieżącego źródła.When this method returns, this parameter contains the specified character array with the values between index and (index + count -1) replaced by the characters read from the current source.

index
Int32

Położenie, w buffer którym rozpocznie się zapisywanie.The position in buffer at which to begin writing.

count
Int32

Maksymalna liczba znaków do odczytania.The maximum number of characters to read.

Zwraca

Int32

Liczba znaków, które zostały odczytane.The number of characters that have been read. Liczba będzie mniejsza lub równa count , w zależności od tego, czy wszystkie znaki wejściowe zostały odczytane.The number will be less than or equal to count, depending on whether all input characters have been read.

Wyjątki

buffer to null.buffer is null.

Długość buforu minus index jest mniejsza niż count .The buffer length minus index is less than count.

index lub count jest ujemna.index or count is negative.

TextReaderJest zamknięty.The TextReader is closed.

Wystąpi błąd We/Wy.An I/O error occurs.

Uwagi

Pozycja czytnika tekstu podstawowego jest zaawansowana przez liczbę znaków, do których zostały odczytane buffer .The position of the underlying text reader is advanced by the number of characters that were read into buffer.

Metoda jest blokowana, dopóki nie count zostaną odczytane znaki lub wszystkie znaki zostały odczytane.The method blocks until either count characters are read, or all characters have been read. Jest to blokowa wersja programu Read .This is a blocking version of Read.

Zobacz też

Dotyczy