Поделиться через


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

Исключения

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

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

Примеры

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

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 метод . Однако этот метод замедляет производительность и должен вызываться только при крайней необходимости.

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

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

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