TextReader.Read Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Č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

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 od čtečky textu nebo -1, pokud nejsou k dispozici 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 se v kódu nevytvořuje instance. Příklad použití metody najdete v ReadStreamReader.Read metodě .

Viz také

• Read()
• Read()
• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru

Read(Span<Char>)

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

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 čtečky. Tato metoda vrátí hodnotu 0 (nula), pokud je volána, když nejsou k přečtení žádné další znaky.

Výjimky

ArgumentNullException

buffer je null.

IOException

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

Read(Char[], Int32, Int32)

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

Int32

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

ArgumentNullException

buffer je null.

ArgumentException

Délka vyrovnávací paměti mínus 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 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é

• Read(Char[], Int32, Int32)
• Read(Char[], Int32, Int32)
• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru