System.IO.StringReader.ReadToEnd 方法
方法描述
将整个流或从流的当前位置到流的结尾作为字符串读取。
语法定义(C# System.IO.StringReader.ReadToEnd 方法 的用法)
public override string ReadToEnd()
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| 返回值 | System.String | 从当前位置到基础字符串的结尾之间的内容。 |
提示和注释
此方法重写 TextReader.ReadToEnd 方法。
如果当前方法引发 OutOfMemoryException，则读取器在基础字符串中的位置将会向前推进此方法能够读取的字符数，而已经读入内部 ReadToEnd 缓冲区中的字符将被放弃。 因为无法更改读取器在字符串中的位置，所以已经读取的字符是无法恢复的，只能通过重新初始化 StringReader 访问它们。 为避免这种情况并产生可靠的代码，应使用 Read 方法，并将已读取的字符存储在预先分配的缓冲区内。
下表列出了其他典型或相关的 I/O 任务的示例。
若要执行此操作...
请参见本主题中的示例...
创建文本文件。
如何：向文件写入文本
写入文本文件。
如何：向文件写入文本
读取文本文件。
如何：从文件读取文本
向文件中追加文本。
如何：打开并追加到日志文件
File.AppendText
FileInfo.AppendText
获取文件大小。
FileInfo.Length
获取文件特性。
File.GetAttributes
设置文件特性。
File.SetAttributes
确定文件是否存在。
File.Exists
读取二进制文件。
如何：对新建的数据文件进行读取和写入
写入二进制文件。
如何：对新建的数据文件进行读取和写入
System.IO.StringReader.ReadToEnd 方法例子
此代码示例摘自一个为 TextReader 类提供的更大示例。
static void ReadText(TextReader textReader)
{
Console.WriteLine("From {0} - {1}",
textReader.GetType().Name, textReader.ReadToEnd());
}
异常
| 异常 | 异常描述 |
|---|---|
| OutOfMemoryException | 内存不足，无法为返回的字符串分配缓冲区。 |
| ObjectDisposedException | 当前读取器已关闭。 |
版本信息
.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 系统要求。