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)

寫入資料流的位元組。

IOException

發生 I/O 錯誤。

資料流不支援寫入，或資料流已經關閉。

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

您 CanWrite 可以使用屬性來判斷目前的實例是否支援寫入。

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