TextReader.ReadLine-Methode

Artikel
08/20/2007

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)

Syntax

'Declaration
Public Overridable Function ReadLine As String
'Usage
Dim instance As TextReader
Dim returnValue As String

returnValue = instance.ReadLine

public virtual string ReadLine ()

public:
virtual String^ ReadLine ()

public String ReadLine ()

public function ReadLine () : String

Rückgabewert

Die nächste Zeile des Eingabestreams oder NULL (Nothing in Visual Basic), wenn alle Zeichen gelesen wurden.

Ausnahmen

Ausnahmetyp	Bedingung
IOException	Ein E/A-Fehler tritt auf.
OutOfMemoryException	Es ist nicht genügend Speicherplatz vorhanden, um einen Puffer für die zurückgegebene Zeichenfolge zu reservieren.
ObjectDisposedException	Der TextReader ist geschlossen.
ArgumentOutOfRangeException	Die Anzahl der Zeichen in der nächsten Zeile ist größer als MaxValue.

Hinweise

Eine Zeile ist definiert als Folge von Zeichen, der ein Wagenrücklauf (0x000d), ein Zeilenvorschub (0x000a), Environment.NewLine oder der Marker für das Streamende folgt. Die zurückgegebene Zeichenfolge enthält keinen abschließenden Wagenrücklauf und/oder Zeilenvorschub. Der zurückgegebene Wert ist NULL (Nothing in Visual Basic), wenn das Ende des Eingabestreams erreicht ist.

Wenn die aktuelle Methode eine OutOfMemoryException auslöst, wird die Position des Readers im zugrunde liegenden Stream um die Anzahl von Zeichen weitergerückt, die die Methode lesen konnte. Die bereits in den internen ReadLine-Puffer gelesenen Zeichen werden jedoch verworfen. Da die Position des Readers im Stream nicht geändert werden kann, können die bereits gelesenen Zeichen nicht wiederhergestellt werden. Auf sie kann nur nach erneuter Initialisierung des TextReader zugegriffen werden. Wenn die Ausgangsposition im Stream unbekannt ist oder der Stream keine Suche unterstützt, muss der zugrunde liegende Stream ebenfalls neu initialisiert werden.

Um diese Situation zu vermeiden und stabilen Code zu erstellen, sollten Sie die Read-Methode verwenden und die gelesenen Zeichen in einem vorher reservierten Puffer speichern.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TextReader-Klasse
TextReader-Member
System.IO-Namespace

Weitere Ressourcen

Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei

Freigeben über