TextReader.ReadToEnd Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest alle Zeichen von der aktuellen Position bis zum Ende der Textsprachausgabe und gibt sie als eine Zeichenfolge zurück.
public:
virtual System::String ^ ReadToEnd();public virtual string ReadToEnd();abstract member ReadToEnd : unit -> string
override this.ReadToEnd : unit -> stringPublic Overridable Function ReadToEnd () As StringGibt zurück
Eine Zeichenfolge, die alle Zeichen von der aktuellen Position bis zum Ende des Textlesers enthält.
Ausnahmen
Ein E/A-Fehler tritt auf.
Das TextReader ist geschlossen.
Es ist nicht genügend Arbeitsspeicher vorhanden, um einen Puffer für die zurückgegebene Zeichenfolge zuzuweisen.
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 Position 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 Datenstrom nicht geändert werden kann, sind die bereits gelesenen Zeichen nicht wiederherstellbar und können nur durch erneutes Initialisieren des TextReaderLesevorgangs aufgerufen werden. Wenn die Anfangsposition innerhalb des Datenstroms unbekannt ist oder der Datenstrom die Suche nicht unterstützt, muss die zugrunde liegende Stream Position ebenfalls 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 unter der StreamReader.ReadToEnd Methode.
