Sdílet prostřednictvím


TextReader.Read Metoda

Definice

Čte data ze čtečky textu.

Přetížení

Read()

Přečte další znak ze čtečky textu a posune pozici znaku o jeden znak.

Read(Span<Char>)

Přečte znaky od aktuálního čtenáře a zapíše data do zadané vyrovnávací paměti.

Read(Char[], Int32, Int32)

Přečte zadaný maximální počet znaků od aktuálního čtenáře a zapíše data do vyrovnávací paměti počínaje zadaným indexem.

Read()

Zdroj:
TextReader.cs
Zdroj:
TextReader.cs
Zdroj:
TextReader.cs

Přečte další znak ze čtečky textu a posune pozici 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

Návraty

Další znak od čtečky textu nebo -1, pokud nejsou k dispozici další znaky. Výchozí implementace vrátí hodnotu -1.

Výjimky

Dojde k vstupně-výstupní chybě.

Poznámky

Třída TextReader je abstraktní třída. Proto se v kódu nevytvořuje instance. Příklad použití metody najdete v ReadStreamReader.Read metodě .

Viz také

Platí pro

Read(Span<Char>)

Zdroj:
TextReader.cs
Zdroj:
TextReader.cs
Zdroj:
TextReader.cs

Přečte znaky od aktuálního čtenáře a zapíše data do zadané vyrovnávací paměti.

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>

Když tato metoda vrátí, obsahuje zadaný rozsah znaků nahrazen znaky přečtené z aktuálního zdroje.

Návraty

Počet přečtených znaků Číslo bude menší nebo rovno buffer délce v závislosti na tom, jestli jsou data dostupná v rámci čtečky. Tato metoda vrátí hodnotu 0 (nula), pokud je volána, když nejsou k přečtení žádné další znaky.

Výjimky

buffer je null.

Počet znaků přečtených z datového proudu je větší než délka znaku buffer.

Platí pro

Read(Char[], Int32, Int32)

Zdroj:
TextReader.cs
Zdroj:
TextReader.cs
Zdroj:
TextReader.cs

Přečte zadaný maximální počet znaků od aktuálního čtenáře a zapíše data do vyrovnávací paměti počínaje zadaným indexem.

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[]

Když tato metoda vrátí hodnotu , obsahuje zadané pole znaků s hodnotami mezi index a (index + count - 1) nahrazenými znaky načtenými z aktuálního zdroje.

index
Int32

Pozice, ve buffer které se má začít psát.

count
Int32

Maximální počet znaků, které se mají přečíst. Pokud je dosaženo konce čtečky před zadaný počet znaků je načten do vyrovnávací paměti, vrátí metoda.

Návraty

Počet přečtených znaků Číslo bude menší nebo rovno hodnotě countv závislosti na tom, jestli jsou data dostupná v rámci čtečky. Tato metoda vrátí hodnotu 0 (nula), pokud je volána, když nejsou k přečtení žádné další znaky.

Výjimky

buffer je null.

Délka vyrovnávací paměti mínus index je menší než count.

index nebo count je negativní.

Dojde k vstupně-výstupní chybě.

Poznámky

Tato metoda vrátí po přečtení znaků count nebo dosažení konce souboru. ReadBlock je blokující verze této metody.

Třída TextReader je abstraktní třída. Proto se v kódu nevytvořuje instance. Příklad použití metody najdete v ReadStreamReader.Read metodě .

Viz také

Platí pro