Stream.ReadByte Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

Stream.cs

Načte bajt z datového proudu a posune pozici v datovém proudu o jeden bajt, nebo vrátí hodnotu -1, pokud je na konci datového proudu.

public:
 virtual int ReadByte();

public virtual int ReadByte ();

abstract member ReadByte : unit -> int
override this.ReadByte : unit -> int

Public Overridable Function ReadByte () As Integer

Návraty

Int32

Bajt bez znaménka Int32přetypuje na , nebo -1, pokud na konci datového proudu.

Výjimky

NotSupportedException

Datový proud nepodporuje čtení.

ObjectDisposedException

Metody byly volány po uzavření datového proudu.

Poznámky

CanRead Pomocí vlastnosti určete, zda aktuální instance podporuje čtení.

Při pokusu o manipulaci s datovým proudem po zavření datového proudu může dojít k chybě ObjectDisposedException.

Poznámky pro dědice

Výchozí implementace v systému Stream vytvoří nové jednobajtů pole a pak zavolá Read(Byte[], Int32, Int32). I když je to formálně správně, je to neefektivní. Jakýkoli datový proud s interní vyrovnávací pamětí by měl tuto metodu přepsat a poskytnout mnohem efektivnější verzi, která čte vyrovnávací paměť přímo, aby se zabránilo přidělení extra pole při každém volání.

Viz také

• Vstupně-výstupní operace souborů a datových proudů
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru