TextReaderReadToEnd

TextReader.ReadToEnd is a method of System.IO.TextReader that reads all characters from the current position to the end of the text source and returns them as a single string. The reader is advanced to the end after the call.

Behavior: If the current position is already at the end, ReadToEnd returns an empty string. The method may throw IOException if an I/O error occurs, ObjectDisposedException if the reader has been closed, or OutOfMemoryException if the resulting string cannot be allocated.

Implementation and performance: In the base class, ReadToEnd is implemented by repeatedly calling Read and appending to a StringBuilder until end of input. Derived classes such as StreamReader may provide more efficient implementations. Because it loads all remaining data into memory, it is best used with reasonably sized inputs.

Usage example: string content; using (var reader = new StreamReader(path)) { content = reader.ReadToEnd(); }

Asynchronous variant: The TextReader class also provides ReadToEndAsync, which returns Task<string> and can be awaited to avoid blocking threads during I/O.

Related members: Read, ReadLine, ReadToEndAsync; See also TextReader, StreamReader, StringReader.