Stream.ReadByte Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.IO

Zestaw:: System.IO.dll

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Źródło:: Stream.cs

Źródło:: Stream.cs

Źródło:: Stream.cs

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.

Odczytuje bajt ze strumienia i rozwija pozycję w strumieniu według jednego bajtu lub zwraca wartość -1, jeśli na końcu strumienia.

public:
 virtual int ReadByte();

public virtual int ReadByte ();

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

Public Overridable Function ReadByte () As Integer

Zwraca

Int32

Niepodpisane bajty rzutowane na Int32obiekt lub -1, jeśli na końcu strumienia.

Wyjątki

NotSupportedException

Strumień nie obsługuje odczytu.

ObjectDisposedException

Metody były wywoływane po zamknięciu strumienia.

Uwagi

Użyj właściwości , CanRead aby określić, czy bieżące wystąpienie obsługuje odczytywanie.

Próby manipulowania strumieniem po zamknięciu strumienia mogą zgłosić błąd ObjectDisposedException.

Uwagi dotyczące dziedziczenia

Domyślna implementacja polecenia Stream tworzy nową tablicę jedno bajtów, a następnie wywołuje metodę Read(Byte[], Int32, Int32). Chociaż jest to formalnie poprawne, jest nieefektywne. Każdy strumień z buforem wewnętrznym powinien zastąpić tę metodę i zapewnić znacznie wydajniejszą wersję odczytującą bufor bezpośrednio, unikając dodatkowej alokacji tablicy na każdym wywołaniu.

Dotyczy