StreamReader.ReadBlock Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Gdy ta metoda zwraca wartość , zawiera określony zakres znaków zastąpiony znakami odczytanych z bieżącego źródła.
Zwraca
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
.
Jest StreamReader zamknięty.
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
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.
Jest StreamReader zamknięty.
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 .