StreamReader.ReadBlock 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

程序集:

netstandard.dll

程序集:

System.Runtime.Extensions.dll

程序集:

System.IO.dll

程序集:

mscorlib.dll

重载

ReadBlock(Span<Char>)	从当前流中读取字符并将数据写入缓冲区。
ReadBlock(Char[], Int32, Int32)	从当前流中读取指定的最大字符数并从指定的索引位置开始将该数据写入缓冲区。

ReadBlock(Span<Char>)

从当前流中读取字符并将数据写入缓冲区。

public:
 override int ReadBlock(Span<char> buffer);

public override int ReadBlock (Span<char> buffer);

override this.ReadBlock : Span<char> -> int

Public Overrides Function ReadBlock (buffer As Span(Of Char)) As Integer

参数

buffer

Span<Char>

此方法返回时，包含指定的字符范围，这些字符由从当前源中读取的字符替换。

返回

Int32

已读取的字符数。 该数字将小于或等于 buffer 长度，具体取决于是否已读取所有输入字符。

例外

ArgumentNullException

buffer 为 null。

ObjectDisposedException

StreamReader 是关闭的。

IOException

出现 I/O 错误。

ReadBlock(Char[], Int32, Int32)

从当前流中读取指定的最大字符数并从指定的索引位置开始将该数据写入缓冲区。

public:
 override int ReadBlock(cli::array <char> ^ buffer, int index, int count);

public override int ReadBlock (char[] buffer, int index, int count);

override this.ReadBlock : char[] * int * int -> int

Public Overrides Function ReadBlock (buffer As Char(), index As Integer, count As Integer) As Integer

参数

buffer

Char[]

当此方法返回时，包含指定字符数组，此数组中 index 和 (index + count - 1) 之间的值被从当前源中读取的字符所替换。

index

Int32

在 buffer 中开始写入的位置。

count

Int32

最多读取的字符数。

返回

Int32

已读取的字符数。 该数字将小于或等于 count，取决于是否所有的输入字符都已读取。

例外

ArgumentNullException

buffer 为 null。

ArgumentException

缓冲区长度减去 index 小于 count。

ArgumentOutOfRangeException

index 或 count 为负数。

ObjectDisposedException

StreamReader 是关闭的。

IOException

出现 I/O 错误。

注解

基础流的位置由读入的字符数来提前 buffer 。

方法会一直阻止 count ，直到读取或到达流的末尾。 这是的一个阻止版 Read 。