TextReader.ReadLine 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

Source:

TextReader.cs

从文本读取器中读取一行字符并将数据作为字符串返回。

public:
 virtual System::String ^ ReadLine();

public virtual string? ReadLine ();

abstract member ReadLine : unit -> string
override this.ReadLine : unit -> string

Public Overridable Function ReadLine () As String

返回

String

读取器中的下一行，或 null（如果已读取所有字符）。

例外

IOException

出现 I/O 错误。

OutOfMemoryException

没有足够的内存来为返回的字符串分配缓冲区。

ObjectDisposedException

TextReader 是关闭的。

ArgumentOutOfRangeException

下一行中的字符数大于 Int32.MaxValue

注解

行定义为后跟回车 (0x000d) 、换行 (0x000a) 、后跟换行 Environment.NewLine符的回车符序列或流结束标记。 返回的字符串不包含终止回车符或换行符。 如果已到达输入流的末尾，则返回值为 null 。

如果方法引发 OutOfMemoryException 异常，则读取器在基础 Stream 中的位置将增加方法能够读取的字符数，但已读入内部 ReadLine 缓冲区的字符将被丢弃。 由于无法更改读取器在流中的位置，因此已读取的字符不可恢复，并且只能通过重新初始化 TextReader 对象来访问。 如果流中的初始位置未知或流不支持查找，则还需要重新初始化基础 Stream 。

若要避免这种情况并生成可靠的代码， Read 应使用 方法并将读取字符存储在预分配的缓冲区中。

类是一个抽象类。 因此，不要在代码中实例化它。 有关使用 ReadLine 方法的示例，请参阅 StreamReader.ReadLine 方法。

另请参阅

• ReadLine()
• ReadLine()
• 文件和流 I/O
• 如何：从文件中读取文本
• 如何：将文本写入文件