TextReader.ReadBlock 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

重载

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

ReadBlock(Char[], Int32, Int32)

Source:

TextReader.cs

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

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

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

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

Public Overridable 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

TextReader 是关闭的。

IOException

出现 I/O 错误。

注解

基础文本读取器的位置由读入 buffer的字符数提升。

方法在读取任一 count 字符或读取所有字符之前阻止。 这是 的 Read阻止版本。

另请参阅

• ReadBlock(Char[], Int32, Int32)
• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件

ReadBlock(Span<Char>)

Source:

TextReader.cs

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

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

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

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

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

参数

buffer

Span<Char>

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

返回

Int32

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

例外

ArgumentNullException

buffer 为 null。

ObjectDisposedException

StreamReader 是关闭的。

IOException

出现 I/O 错误。