TextReader.Read Metoda

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
System.IO.dll
Sestavení:
System.Runtime.dll
Sestavení:
System.Runtime.Extensions.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Čte data z textové čtečky.

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 z aktuální čtečky 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í čtečky a zapíše data do vyrovnávací paměti počínaje zadaným indexem.

Read()

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

Int32

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

Výjimky

ObjectDisposedException

Je TextReader zavřený.

IOException

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

Poznámky

Třída TextReader je abstraktní třída. Proto ho v kódu neodstraňujete. Příklad použití Read metody najdete v StreamReader.Read metodě.

Viz také

Platí pro

Read(Span<Char>)

Přečte znaky z aktuální čtečky 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é rozsahy znaků nahrazené znaky přečtené z aktuálního zdroje.

Návraty

Int32

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 čtenáře. Tato metoda vrátí hodnotu 0 (nula), pokud je volána, pokud se nepřečtou žádné další znaky.

Výjimky

ArgumentNullException

buffer je null.

IOException

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

Platí pro

Read(Char[], Int32, Int32)

Přečte zadaný maximální počet znaků od aktuální čtečky 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í, obsahuje zadané znakové pole s hodnotami mezi index a (index + count - 1) nahrazené znaky přečtenými z aktuálního zdroje.

index
Int32

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

count
Int32

Maximální počet znaků, které se mají číst. Pokud je konec čtenáře dosažen před načtením zadaného počtu znaků do vyrovnávací paměti, vrátí metoda.

Návraty

Int32

Počet přečtených znaků. Číslo bude menší než nebo rovno count, v závislosti na tom, jestli jsou data dostupná v rámci čtenáře. Tato metoda vrátí hodnotu 0 (nula), pokud je volána, pokud se nepřečtou žádné další znaky.

Výjimky

ArgumentNullException

buffer je null.

ArgumentException

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

ArgumentOutOfRangeException

index nebo count je negativní.

ObjectDisposedException

Je TextReader zavřený.

IOException

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

Poznámky

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

Třída TextReader je abstraktní třída. Proto ho v kódu neodstraňujete. Příklad použití Read metody najdete v StreamReader.Read metodě.

Viz také

Platí pro