Stream.WriteByte(Byte) 方法

定义

将一个字节写入流内的当前位置,并将流内的位置向前提升一个字节。

C#
public virtual void WriteByte (byte value);

参数

value
Byte

要写入流中的字节。

例外

出现 I/O 错误。

该流不支持写入,或者该流已关闭。

在流关闭后调用方法。

注解

CanWrite使用 属性确定当前实例是否支持写入。

继承者说明

Stream 的默认实现创建新的单字节数组,然后调用 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

另请参阅