TextReader.ReadToEnd 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 alle Zeichen von der aktuellen Position bis zum Ende des Text-Readers und gibt diese als eine Zeichenfolge zurück.

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

Gibt zurück

String

Eine Zeichenfolge mit allen Zeichen von der aktuellen Position bis zum Ende des Textreaders.

Ausnahmen

IOException

Ein E/A-Fehler tritt auf.

ObjectDisposedException

Der TextReader ist geschlossen.

OutOfMemoryException

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

ArgumentOutOfRangeException

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

Hinweise

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 ReadToEnd Puffer gelesen wurden, werden verworfen. Da die Position des Lesers im Stream nicht geändert werden kann, können die bereits gelesenen Zeichen nicht wiederhergestellt werden und nur durch erneute Initialisierung des TextReaderzugegriffen 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 ReadToEnd -Methode finden Sie in der StreamReader.ReadToEnd -Methode.

Gilt für:

Weitere Informationen