英語で読む

次の方法で共有


Stream.WriteByte(Byte) メソッド

定義

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

C#
public virtual void WriteByte (byte value);

パラメーター

value
Byte

ストリームに書き込むバイト。

例外

I/O エラーが発生します。

ストリームが書き込みをサポートしていないか、既に閉じています。

ストリームが閉じた後でメソッドが呼び出されました。

注釈

プロパティを使用して、 CanWrite 現在のインスタンスが書き込みをサポートしているかどうかを判断します。

注意 (継承者)

の既定の実装 Stream では、新しい 1 バイト配列が作成され、 が呼び出 Write(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

こちらもご覧ください