TextReader.ReadLine 方法

定义

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

public:
 virtual System::String ^ ReadLine();
public virtual string ReadLine ();
public virtual string? ReadLine ();
abstract member ReadLine : unit -> string
override this.ReadLine : unit -> string
Public Overridable Function ReadLine () As String

返回

读取器中的下一行,或 null(如果已读取所有字符)。

例外

出现 I/O 错误。

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

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

注解

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

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

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

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

适用于

另请参阅