TextReader.ReadLine 方法

项目
08/17/2007

从当前流中读取一行字符并将数据作为字符串返回。

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

语法

声明
Public Overridable Function ReadLine As String
用法
Dim instance As TextReader
Dim returnValue As String

returnValue = instance.ReadLine

public virtual string ReadLine ()

public:
virtual String^ ReadLine ()

public String ReadLine ()

public function ReadLine () : String

返回值

输入流的下一行，或者如果已读取了所有字符，则为空引用（在 Visual Basic 中为 Nothing）。

异常

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

备注

将行定义为一个后跟回车符 (0x000d)、换行符 (0x000a)、Environment.NewLine 或流末尾标记的字符序列。返回的字符串不包含终止回车符和/或换行符。如果到达了输入流的末尾，返回值为空引用（在 Visual Basic 中为 Nothing）。

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

为避免这种情况并产生可靠的代码，应使用 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.ReadLine 方法

语法

返回值

异常

备注

平台

版本信息

.NET Framework

.NET Compact Framework

请参见

参考

其他资源

其他资源