Stream.ReadByte 方法

定义

从流中读取一个字节,并将流内的位置向前提升一个字节,或者如果已到达流结尾,则返回 -1。

public:
 virtual int ReadByte();
public virtual int ReadByte ();
abstract member ReadByte : unit -> int
override this.ReadByte : unit -> int
Public Overridable Function ReadByte () As Integer

返回

强制转换为 Int32 的无符号字节,如果到达流的末尾,则为 -1。

例外

流不支持读取。

在流关闭后调用方法。

注解

CanRead使用 属性确定当前实例是否支持读取。

在关闭流后尝试操作流可能会引发 ObjectDisposedException

继承者说明

Stream 的默认实现创建一个新的单字节数组,然后调用 Read(Byte[], Int32, Int32)。 虽然这是正式正确的,但它效率低下。 具有内部缓冲区的任何流都应重写此方法,并提供一个更高效的版本来直接读取缓冲区,避免每次调用时都分配额外的数组。

适用于

另请参阅