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 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 -> stringPublic Overridable Function ReadToEnd () As StringGibt zurück
Eine Zeichenfolge mit allen Zeichen von der aktuellen Position bis zum Ende des Textreaders.
Ausnahmen
Ein E/A-Fehler tritt auf.
Der TextReader ist geschlossen.
Es ist nicht genügend Speicher vorhanden, um einen Puffer für die zurückgegebene Zeichenfolge zuzuordnen.
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.
