BufferedStream.ReadByte 方法

定義

從基礎資料流讀取位元組並傳回轉型為 int 的位元組;如果從資料流末端讀取,則傳回 -1。

public override int ReadByte ();

傳回

轉換為 int 的位元組;如果從資料流末端讀取,則為 -1。

例外狀況

發生 I/O 錯誤,例如資料流已經關閉。

資料流不支援讀取。

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

給繼承者的注意事項

上的 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.5, 1.6, 2.0, 2.1

另請參閱