StreamReader.ReadLine Метод

Определение

Пространство имен:

System.IO

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

StreamReader.cs

Считывает строку символов из текущего потока и возвращает данные в виде строки.

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

public override string? ReadLine();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

Возвращаемое значение

String

Следующая строка из входного потока или null достигается конец входного потока.

Исключения

OutOfMemoryException

Недостаточно памяти для выделения буфера для возвращаемой строки.

IOException

Возникает ошибка ввода-вывода.

Примеры

Следующий пример кода считывает строки из файла до конца файла.

using System;
using System.IO;

class Test
{
    
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        try
        {
            if (File.Exists(path))
            {
                File.Delete(path);
            }

            using (StreamWriter sw = new StreamWriter(path))
            {
                sw.WriteLine("This");
                sw.WriteLine("is some text");
                sw.WriteLine("to test");
                sw.WriteLine("Reading");
            }

            using (StreamReader sr = new StreamReader(path))
            {
                while (sr.Peek() >= 0)
                {
                    Console.WriteLine(sr.ReadLine());
                }
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

Imports System.IO
Imports System.Text

Public Class Test

    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        Try
            If File.Exists(path) Then
                File.Delete(path)
            End If

            Dim sw As StreamWriter = New StreamWriter(path)
            sw.WriteLine("This")
            sw.WriteLine("is some text")
            sw.WriteLine("to test")
            sw.WriteLine("Reading")
            sw.Close()

            Dim sr As StreamReader = New StreamReader(path)

            Do While sr.Peek() >= 0
                Console.WriteLine(sr.ReadLine())
            Loop
            sr.Close()
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

Комментарии

Строка определяется как последовательность символов, за которой следует канал строки ("\n"), возврат каретки ("\r"), или возврат каретки сразу после канала строки ("\r\n"). Возвращаемая строка не содержит конца возвращаемого каретки или канала строки. Возвращаемое значение — если null достигается конец входного потока.

Если поток заканчивается новой последовательностью, возвращается дополнительная пустая строка. Например, поток, "line1\nline2\n" содержащий одну и ту же линию ("line1" и "line2") в виде потока, "line1\nline2"содержащего.

Этот метод переопределяет метод TextReader.ReadLine.

Если текущий метод создает исключение OutOfMemoryException, позиция читателя в базовом Stream объекте расширена по количеству символов, которые метод смог считывать, но символы, которые уже считываются во внутренний ReadLine буфер, удаляются. Если вы управляете положением базового потока после чтения данных в буфер, позиция базового потока может не совпадать с положением внутреннего буфера. Чтобы сбросить внутренний буфер, вызовите DiscardBufferedData метод. Однако этот метод замедляет производительность и должен вызываться только при абсолютной необходимости.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• Файловый и потоковый ввод-вывод
• Практическое руководство. Чтение текста из файла
• Практическое руководство. Запись текста в файл