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 im 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, sind die bereits gelesenen Zeichen nicht wiederherstellbar und können nur durch erneutes Initialisieren des TextReaderzugegriffen werden. Wenn die anfangse Position im Stream unbekannt ist oder der Stream die Suche nicht unterstützt, muss auch die zugrunde liegende Stream Position neu initialisiert werden.

Um eine solche Situation zu vermeiden und robusten Code zu erstellen, 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 im Code. Ein Beispiel für die Verwendung der ReadToEnd -Methode finden Sie in der StreamReader.ReadToEnd -Methode.

Gilt für:

Weitere Informationen