TextReader.ReadLine Methode

  • Referenz

Definition

Namespace:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
TextReader.cs
Quelle:
TextReader.cs
Quelle:
TextReader.cs

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

public:
 virtual System::String ^ ReadLine();
public virtual string ReadLine ();
public virtual string? ReadLine ();
abstract member ReadLine : unit -> string
override this.ReadLine : unit -> string
Public Overridable Function ReadLine () As String

Gibt zurück

String

Die nächste Zeile des Readers oder null, wenn alle Zeichen gelesen wurden.

Ausnahmen

IOException

Ein E/A-Fehler tritt auf.

OutOfMemoryException

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

ObjectDisposedException

Der TextReader ist geschlossen.

ArgumentOutOfRangeException

Die Anzahl der Zeichen in der nächsten Zeile ist größer als Int32.MaxValue.

Hinweise

Eine Zeile wird als Folge von Zeichen definiert, gefolgt von einem Wagenrücklauf (0x000d), einem Zeilenvorschub (0x000a), einem Wagenrücklauf gefolgt von einem Zeilenvorschub, Environment.NewLineoder dem Marker zum Ende des Datenstroms. Die zurückgegebene Zeichenfolge enthält nicht den beendenden Wagenrücklauf oder Zeilenvorschub. Der Rückgabewert ist null , wenn das Ende des Eingabedatenstroms erreicht wurde.

Wenn die Methode eine OutOfMemoryException Ausnahme auslöst, wird die Position des Lesers in der zugrunde liegenden Stream um die Anzahl der Zeichen erweitert, die die Methode lesen konnte, aber die Zeichen, die bereits in den internen ReadLine Puffer gelesen wurden, werden verworfen. Da die Position des Readers im Stream nicht geändert werden kann, können die bereits gelesenen Zeichen nicht wiederhergestellt werden und nur durch erneute Initialisierung des TextReader Objekts aufgerufen werden. Wenn die anfängliche Position im Stream unbekannt ist oder der Stream die Suche nicht unterstützt, muss auch die zugrunde liegende Stream neu initialisiert werden.

Um eine solche Situation zu vermeiden und robusten Code zu erzeugen, sollten Sie die Read -Methode verwenden und die Lesezeichen in einem vorab zugewiesenen Puffer speichern.

Die TextReader-Klasse ist eine abstrakte Klasse. Daher instanziieren Sie sie nicht in Ihrem Code. Ein Beispiel für die Verwendung der ReadLine -Methode finden Sie in der StreamReader.ReadLine -Methode.

Gilt für:

Weitere Informationen