TextReader.ReadToEnd Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Leest alle tekens van de huidige positie tot het einde van de tekstlezer en retourneert deze als één tekenreeks.
public:
virtual System::String ^ ReadToEnd();public virtual string ReadToEnd();abstract member ReadToEnd : unit -> string
override this.ReadToEnd : unit -> stringPublic Overridable Function ReadToEnd () As StringRetouren
Een tekenreeks die alle tekens van de huidige positie tot het einde van de tekstlezer bevat.
Uitzonderingen
Er treedt een I/O-fout op.
De TextReader is gesloten.
Er is onvoldoende geheugen om een buffer toe te wijzen voor de geretourneerde tekenreeks.
Het aantal tekens in de volgende regel is groter dan Int32.MaxValue
Opmerkingen
Als de methode een OutOfMemoryException uitzondering genereert, wordt de positie van de lezer in de onderliggende Stream waarde geavanceerd door het aantal tekens dat de methode kon lezen, maar worden de tekens die al in de interne ReadToEnd buffer zijn gelezen, verwijderd. Omdat de positie van de lezer in de stroom niet kan worden gewijzigd, zijn de tekens die al zijn gelezen, onherstelbaar en kunnen ze alleen worden geopend door het TextReaderopnieuw te initialiseren. Als de initiële positie in de stream onbekend is of de stream geen ondersteuning biedt voor zoeken, moet de onderliggende Stream positie ook opnieuw worden geïnitialiseerd.
Als u een dergelijke situatie wilt voorkomen en robuuste code wilt produceren, moet u de Read methode gebruiken en de leestekens opslaan in een vooraf toegewezen buffer.
De TextReader klasse is een abstracte klasse. Daarom maakt u deze niet instantiëren in uw code. Zie de methode voor een voorbeeld van het gebruik van de ReadToEndStreamReader.ReadToEnd methode.
