Stream.ReadByte 方法
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
從資料流讀取一個位元組,並將資料流的位置推進一個位元組;如果在資料流末端,則傳回 -1。
public:
virtual int ReadByte();
C#
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)。 雖然這正式正確,但效率不佳。 任何具有內部緩衝區的數據流都應該覆寫此方法,並提供更有效率的版本,直接讀取緩衝區,以避免每次呼叫時都配置額外的陣列。
產品 | 版本 |
---|---|
.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 |