Stream.ReadByte 方法
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
从流中读取一个字节,并将流内的位置向前提升一个字节,或者如果已到达流结尾,则返回 -1。
public:
virtual int ReadByte();
C#
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)。 虽然这是正式正确的,但它效率低下。 具有内部缓冲区的任何流都应重写此方法,并提供一个更高效的版本来直接读取缓冲区,避免每次调用时都分配额外的数组。
产品 | 版本 |
---|---|
.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 |