Stream.WriteByte(Byte) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
寫入一個位元組至資料流的目前位置,並將資料流位置推進一個位元組。
public:
virtual void WriteByte(System::Byte value);
public virtual void WriteByte (byte value);
abstract member WriteByte : byte -> unit
override this.WriteByte : byte -> unit
Public Overridable Sub WriteByte (value As Byte)
參數
- value
- Byte
寫入資料流的位元組。
例外狀況
發生 I/O 錯誤。
資料流不支援寫入,或資料流已經關閉。
關閉資料流後呼叫了方法。
備註
CanWrite使用屬性來判斷目前實例是否支援寫入。
給繼承者的注意事項
上的 Stream
預設實作會建立新的單一位元組數組,然後呼叫 Write(Byte[], Int32, Int32)。 雖然這正式正確,但效率不佳。 任何具有內部緩衝區的數據流都應該覆寫這個方法,並提供更有效率的版本,直接寫入緩衝區,以避免每次呼叫時都配置額外的陣列。