Stream.WriteByte(Byte) メソッド

定義

ストリームの現在位置にバイトを書き込み、ストリームの位置を 1 バイトだけ進めます。

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 では、新しい 1 バイト配列が作成され、 が呼び出 Write(Byte[], Int32, Int32)されます。 これは正式には正しいですが、非効率的です。 内部バッファーを持つストリームでは、このメソッドをオーバーライドし、バッファーに直接書き込むはるかに効率的なバージョンを提供する必要があります。これにより、すべての呼び出しで余分な配列割り当てが回避されます。

適用対象

こちらもご覧ください