StringReader::ReadToEnd Method
Reads all characters from the current position to the end of the string and returns them as a single string.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Return Value
Type: System::StringThe content from the current position to the end of the underlying string.
| Exception | Condition |
|---|---|
| OutOfMemoryException | There is insufficient memory to allocate a buffer for the returned string. |
| ObjectDisposedException | The current reader is closed. |
This method overrides the TextReader::ReadToEnd method.
If the current method throws an OutOfMemoryException, the reader's position in the underlying string is advanced by the number of characters the method was able to read, but the characters already read into the internal ReadToEnd buffer are discarded. Because the position of the reader in the string cannot be changed, the characters already read are unrecoverable, and can be accessed only by reinitializing the StringReader. To avoid such a situation, use the Read method and store the read characters in a preallocated buffer.
The following table lists examples of other typical or related I/O tasks.
To do this... | See the example in this topic... |
|---|---|
Create a text file. | |
Write to a text file. | |
Read from a text file. | |
Append text to a file. | |
Get the size of a file. | |
Get the attributes of a file. | |
Set the attributes of a file. | |
Determine if a file exists. | |
Read from a binary file. | |
Write to a binary file. |
This code example is part of a larger example provided for the TextReader class.
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
