Stream.ReadByte 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

从流中读取一个字节，并将流内的位置向前提升一个字节，或者如果已到达流结尾，则返回 -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

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

流不支持读取。

在流关闭后调用方法。

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

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

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