StringReader.ReadLine 方法

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

public override string ReadLine();

public override string? ReadLine();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

返回

当前字符串中的下一行，或者 null 到达字符串的末尾。

例外

示例

该代码示例是 StringReader 类中的一个较大示例的一部分。

// From textReaderText, create a continuous paragraph
// with two spaces between each sentence.
string aLine, aParagraph = null;
StringReader strReader = new StringReader(textReaderText);
while(true)
{
    aLine = strReader.ReadLine();
    if(aLine != null)
    {
        aParagraph = aParagraph + aLine + " ";
    }
    else
    {
        aParagraph = aParagraph + "\n";
        break;
    }
}
Console.WriteLine("Modified text:\n\n{0}", aParagraph);

' From textReaderText, create a continuous paragraph 
' with two spaces between each sentence.
Dim aLine, aParagraph As String
Dim strReader As New StringReader(textReaderText)
While True
    aLine = strReader.ReadLine()
    If aLine Is Nothing Then
        aParagraph = aParagraph & vbCrLf
        Exit While
    Else
        aParagraph = aParagraph & aLine & " "
    End If
End While
Console.WriteLine("Modified text:" & vbCrLf & vbCrLf & _ 
    aParagraph)

注解

此方法替代 TextReader.ReadLine 该方法。

行被定义为后跟换行符（“\n”、“回车符（”\r“），回车符紧跟换行符（”\r\n“）或流结束标记的字符序列。 返回的字符串不包含终止回车符或换行符。 返回的值是 null 已达到流结束标记。 也就是说，如果最后一行读取和流结束标记之间没有任何内容，该方法将 null返回。

如果字符串以换行序列结尾，则不会返回其他空行。 例如，字符串"line1\nline2\n"生成与字符串"line1\nline2"相同的两行（"line1"和"line2"）。

如果当前方法引发一个 OutOfMemoryException，则基础字符串中的读取器位置由该方法能够读取的字符数进行高级，但已读入内部 ReadLine 缓冲区的字符将被丢弃。 由于无法更改读取器在字符串中的位置，因此已读取的字符不可恢复，并且只能通过重新初始化来 StringReader访问。 为了避免这种情况，请使用 Read 该方法并将读取字符存储在预先分配的缓冲区中。

下表列出了其他典型或相关的 I/O 任务的示例。

另请参阅

• 文件和流输入/输出
• 如何：从文件读取文本
• 如何：将文本写入文件