StreamReader.ReadLine Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Źródło:

StreamReader.cs

Odczytuje wiersz znaków z bieżącego strumienia i zwraca dane jako ciąg.

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

public override string? ReadLine ();

override this.ReadLine : unit -> string

Public Overrides Function ReadLine () As String

Zwraca

String

Następny wiersz ze strumienia wejściowego lub null jeśli osiągnięto koniec strumienia wejściowego.

Wyjątki

OutOfMemoryException

Za mało pamięci, aby przydzielić bufor dla zwracanego ciągu.

IOException

Wystąpi błąd We/Wy.

Przykłady

Poniższy przykład kodu odczytuje wiersze z pliku do momentu osiągnięcia końca pliku.

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

Uwagi

Wiersz jest definiowany jako sekwencja znaków, po której następuje źródło wiersza ("\n"), powrót karetki ("\r") lub powrót karetki bezpośrednio po wierszu ("\r\n"). Zwracany ciąg nie zawiera powrotu karetki zakończenia ani kanału informacyjnego wiersza. Zwracana wartość to null , jeśli osiągnięto koniec strumienia wejściowego.

Ta metoda zastępuje TextReader.ReadLine.

Jeśli bieżąca metoda zgłasza OutOfMemoryExceptionbłąd , pozycja czytelnika w obiekcie bazowym Stream jest zaawansowana przez liczbę znaków, które metoda mogła odczytać, ale znaki już odczytane w buforze wewnętrznym ReadLine są odrzucane. W przypadku manipulowania położeniem strumienia bazowego po odczytaniu danych do buforu pozycja bazowego strumienia może nie być zgodna z położeniem buforu wewnętrznego. Aby zresetować bufor wewnętrzny, wywołaj metodę DiscardBufferedData , jednak ta metoda spowalnia wydajność i powinna być wywoływana tylko wtedy, gdy jest to absolutnie konieczne.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• Plik i Stream we/wy
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku