System.IO.TextReader.ReadToEnd 方法

方法描述

读取从当前位置到 TextReader 的结尾的所有字符并将它们作为一个字符串返回。

语法定义(C# System.IO.TextReader.ReadToEnd 方法 的用法)

public virtual string ReadToEnd()

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
返回值 System.String 包含从当前位置到 TextReader 的结尾的所有字符的字符串。

提示和注释

如果当前方法引发 OutOfMemoryException,则读取器在基础 Stream 中的位置会向前推进该方法能够读取的字符数,而已经读入内部 ReadToEnd 缓冲区中的字符将被放弃。 因为无法更改读取器在流中的位置,所以已经读取的字符是无法恢复的,只能通过重新初始化 TextReader 访问它们。 如果流内的初始位置未知,或者流不支持查找,则也需要重新初始化基础 Stream。

为避免这种情况并产生可靠的代码,应使用 Read 方法,并将已读取的字符存储在预先分配的缓冲区内。

System.IO.TextReader.ReadToEnd 方法例子


异常

异常 异常描述
IOException 发生 I/O 错误。
ObjectDisposedException TextReader 是关闭的。
OutOfMemoryException 内存不足,无法为返回的字符串分配缓冲区。
ArgumentOutOfRangeException 下一行中的字符数大于 MaxValue

命名空间

namespace: System.IO

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。