Stream.ReadByte 方法

定義

從資料流讀取一個位元組,並將資料流的位置推進一個位元組;如果在資料流末端,則傳回 -1。

C#
public virtual int ReadByte ();

傳回

轉型為 Int32 的不帶正負號位元組,如果在資料流末端,則為 -1。

例外狀況

資料流不支援讀取。

關閉資料流後呼叫了方法。

備註

CanRead使用屬性來判斷目前的實例是否支援讀取。

試著在關閉資料串流之後操作資料流可能會擲回 ObjectDisposedException

給繼承者的注意事項

上的預設實作 Stream 會建立新的單一位元組數組,然後呼叫 Read(Byte[], Int32, Int32)。 雖然這正式正確,但效率不佳。 任何具有內部緩衝區的數據流都應該覆寫此方法,並提供更有效率的版本,直接讀取緩衝區,以避免每次呼叫時都配置額外的陣列。

適用於

產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

另請參閱