StreamReader.ReadLine Метод

  • Ссылка

Определение

Пространство имен:
System.IO
Сборка:
System.IO.dll
Сборка:
System.Runtime.dll
Сборка:
netstandard.dll
Сборка:
System.Runtime.Extensions.dll
Сборка:
mscorlib.dll

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

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

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

String

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

Исключения

OutOfMemoryException

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

IOException

Ошибка ввода-вывода.

Примеры

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

using namespace System;
using namespace System::IO;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   try
   {
      if ( File::Exists( path ) )
      {
         File::Delete( path );
      }
      StreamWriter^ sw = gcnew StreamWriter( path );
      try
      {
         sw->WriteLine( "This" );
         sw->WriteLine( "is some text" );
         sw->WriteLine( "to test" );
         sw->WriteLine( "Reading" );
      }
      finally
      {
         delete sw;
      }

      StreamReader^ sr = gcnew StreamReader( path );
      try
      {
         while ( sr->Peek() >= 0 )
         {
            Console::WriteLine( sr->ReadLine() );
         }
      }
      finally
      {
         delete sr;
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }
}

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 если достигнут конец входного потока.

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

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

Список общих задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

Применяется к

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