TextReader.ReadLine-Methode
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 |
|---|---|
Ein E/A-Fehler tritt auf. |
|
Es ist nicht genügend Speicherplatz vorhanden, um einen Puffer für die zurückgegebene Zeichenfolge zu reservieren. |
|
Der TextReader ist geschlossen. |
|
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