导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

Stream.Read 方法

2013/12/13

在派生类中重写时,从当前流读取字节序列并且将流的位置向前移动所读取的字节数。

Namespace:  System.IO
程序集:  mscorlib(位于 mscorlib.dll 中)

public abstract int Read(
	byte[] buffer,
	int offset,
	int count
)

参数

buffer
类型: System.Byte []
字节数组。该方法有返回值时,缓冲区包括指定的字节数组,数组中在offset和(offset + count - 1)之间的值由从当前源读取的字节替代。
offset
类型: System.Int32
buffer 中的从零开始的字节偏移量,从此处开始存储从当前流中读取的数据。
count
类型: System.Int32
要从当前流中最多读取的字节数。

返回值

类型: System.Int32
读入缓冲区中的总字节数。如果当前可用的字节数没有请求的字节数那么多,则总字节数可能小于请求的字节数,或者如果已到达流的末尾,则为零 (0)。

异常条件
ArgumentException

offsetcount 的和大于缓冲区长度。

ArgumentNullException

buffernull

ArgumentOutOfRangeException

offsetcount 为负。

IOException

发生 I/O 错误。

NotSupportedException

流不支持读取。

ObjectDisposedException

在流关闭后调用方法。

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

此方法的实现从当前流中读取最多的 count 个字节,并将它们存储在从 offset 开始的 buffer 中。流中的当前位置提升已读取的字节数;但是,如果出现异常,流中的当前位置保持不变。实现返回已读取的字节数。仅当位置当前位于流的末尾时,返回值才为零。如果没有任何可用的数据,实现将会阻止,直到至少有一个字节的数据可供读取。仅当流中没有更多数据且预期不会有更多数据(如套接字已关闭或位于文件结尾)时,Read 才返回 0。即使尚未到达流的末尾,实现仍可以随意返回少于所请求的字节。

BinaryReader 用于读取基元数据类型。

Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

显示:
© 2015 Microsoft