Stream.ReadByte 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
從資料流讀取一個位元組,並將資料流的位置推進一個位元組;如果在資料流末端,則傳回 -1。
public:
virtual int ReadByte();
public virtual int ReadByte ();
abstract member ReadByte : unit -> int
override this.ReadByte : unit -> int
Public Overridable Function ReadByte () As Integer
傳回
轉型為 Int32 的不帶正負號位元組,如果在資料流末端,則為 -1。
例外狀況
資料流不支援讀取。
關閉資料流後呼叫了方法。
備註
您 CanRead 可以使用屬性來判斷目前的實例是否支援讀取。
當資料流程關閉之後,嘗試運算元據流可能會擲回 ObjectDisposedException 。
給繼承者的注意事項
上的預設實值會 Stream
建立新的單一位元組陣列,然後呼叫 Read(Byte[], Int32, Int32) 。 雖然這是正式正確的,但效率不佳。 任何具有內部緩衝區的資料流程都應該覆寫此方法,並提供更有效率的版本來直接讀取緩衝區,以避免每次呼叫時產生額外的陣列配置。