StreamReader.ReadBlock Metoda

Definicja

Przeciążenia

ReadBlock(Span<Char>)

Odczytuje znaki z bieżącego strumienia i zapisuje dane w buforze.

ReadBlock(Char[], Int32, Int32)

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

ReadBlock(Span<Char>)

Odczytuje znaki z bieżącego strumienia i zapisuje dane w buforze.

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

Parametry

buffer
Span<Char>

Gdy ta metoda zwraca wartość , zawiera określony zakres znaków zastąpiony znakami odczytanych z bieżącego źródła.

Zwraca

Int32

Liczba odczytanych znaków. Liczba będzie mniejsza lub równa długości, w zależności od tego, czy wszystkie znaki buffer wejściowe zostały odczytane.

Wyjątki

buffer to null.

Wystąpił błąd we/wy.

Dotyczy

ReadBlock(Char[], Int32, Int32)

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

public:
 override int ReadBlock(cli::array <char> ^ buffer, int index, int count);
public override int ReadBlock (char[] buffer, int index, int count);
override this.ReadBlock : char[] * int * int -> int
Public Overrides Function ReadBlock (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 od i (indeks + liczba - 1 ) zastąpionymi znakami index odczytanych zbieżącego źródła.

index
Int32

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

count
Int32

Maksymalna liczba znaków do odczytania.

Zwraca

Int32

Liczba odczytanych znaków. Liczba będzie mniejsza niż lub równa , w zależności od tego, czy wszystkie znaki count wejściowe zostały odczytane.

Wyjątki

buffer to null.

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

index wartość lub count jest ujemna.

Wystąpił błąd we/wy.

Uwagi

Pozycja bazowego strumienia jest zaawansowana przez liczbę znaków, które zostały odczytane do buffer .

Metoda blokuje się, dopóki nie zostaną odczytane znaki lub koniec count strumienia nie zostanie osiągnięty. Jest to wersja blokująca programu Read .

Dotyczy