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

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

資料流不支援讀取。

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

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

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

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