Stream.ReadByte Metoda
Definicja
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
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ż
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla