StreamReader.ReadLine Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestawy:

netstandard.dll, 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 do przydzielenia buforu dla zwracanego ciągu.

IOException

Występuje błąd we/wy.

Przykłady

Poniższy przykład kodu odczytuje wiersze z pliku do końca pliku.

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

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

Jeśli strumień kończy się sekwencją nowego wiersza, nie zostanie zwrócony dodatkowy pusty wiersz. Na przykład strumień zawierający "line1\nline2\n" tworzy te same dwa wiersze ("line1" i "line2") jako strumień zawierający "line1\nline2".

Ta metoda zastępuje metodę 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 bazowego strumienia po odczytaniu danych do buforu pozycja bazowego strumienia może nie być zgodna z pozycją 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ż

• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku