Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

StreamReader.ReadLine-Methode: ()

 

Veröffentlicht: Oktober 2016

Liest eine Zeile von Zeichen aus dem aktuellen Stream und gibt die Daten als Zeichenfolge zurück.

Namespace:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

public override string ReadLine()

Rückgabewert

Type: System.String

Die nächste Zeile des Eingabestreams bzw. null, wenn das Ende des Eingabestreams erreicht ist.

Exception Condition
OutOfMemoryException

Es ist nicht genügend Speicher vorhanden, um einen Puffer für die zurückgegebene Zeichenfolge zuzuordnen.

IOException

Ein E/A-Fehler tritt auf.

Eine Zeile ist definiert als eine Folge von Zeichen, gefolgt von einer Zeile Zeilenvorschub ("\n"), ein Wagenrücklauf ("\r") oder ein Wagenrücklauf, gefolgt von einer Zeile Zeilenvorschub ("\r\n"). Die Zeichenfolge, die zurückgegeben wird, enthält keine abschließende Wagenrücklauf oder Zeilenvorschub. Der zurückgegebene Wert ist null wenn das Ende des Eingabestreams erreicht ist.

Diese Methode überschreibt TextReader.ReadLine.

Sofern die aktuelle Methode eine OutOfMemoryException auslöst, wird die Position des Readers im zugrunde liegenden Stream Objekt um die Anzahl der Zeichen weitergerückt, die die Methode lesen konnte, aber die bereits in den internen ReadLine-Puffer gelesenen Zeichen werden verworfen. Wenn Sie die Position des zugrunde liegenden Streams ändern, nachdem Daten in den Puffer gelesen, passt die Position des zugrunde liegenden Streams nicht die Position des internen Puffers. Um den internen Puffer zurückzusetzen, rufen Sie die DiscardBufferedData Methode jedoch diese Methode verlangsamt die Leistung und sollte nur aufgerufen, wenn dies absolut notwendig.

Eine Liste allgemeiner e/a-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Das folgende Codebeispiel liest die Zeilen aus einer Datei, bis das Ende der Datei erreicht ist.

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());
        }
    }
}

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: