TextReader.ReadBlock 方法

项目
08/17/2007

从当前流中读取最大 count 的字符并从 index 开始将该数据写入 buffer。

**命名空间:**System.IO
**程序集:**mscorlib（在 mscorlib.dll 中）

语法

声明
Public Overridable Function ReadBlock ( _
    <InAttribute> <OutAttribute> buffer As Char(), _
    index As Integer, _
    count As Integer _
) As Integer
用法
Dim instance As TextReader
Dim buffer As Char()
Dim index As Integer
Dim count As Integer
Dim returnValue As Integer

returnValue = instance.ReadBlock(buffer, index, count)

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

public:
virtual int ReadBlock (
    [InAttribute] [OutAttribute] array<wchar_t>^ buffer, 
    int index, 
    int count
)

public int ReadBlock (
    /** @attribute InAttribute() */ /** @attribute OutAttribute() */ char[] buffer, 
    int index, 
    int count
)

public function ReadBlock (
    buffer : char[], 
    index : int, 
    count : int
) : int

参数

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

index
buffer 中开始写入的位置。

count
最多读取的字符数。

返回值

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

异常

异常类型	条件
ArgumentNullException	buffer 为空引用（在 Visual Basic 中为 Nothing）。
ArgumentException	缓冲区长度减去 index 小于 count。
ArgumentOutOfRangeException	index 或 count 为负。
ObjectDisposedException	TextReader 是关闭的。
IOException	发生 I/O 错误。

备注

此方法将阻塞，直到读取数目为 count 的字符或读取了所有字符。这是 Read 的条块化版本。

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

通过

TextReader.ReadBlock 方法

语法

参数

返回值

异常

备注

平台

版本信息

.NET Framework

.NET Compact Framework

请参见

参考

其他资源

其他资源