Udostępnij za pośrednictwem


Stream.ReadByte Metoda

Definicja

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

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

Wyjątki

Strumień nie obsługuje odczytu.

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

Zobacz też