StringReader Class
Implements a TextReader that reads from a string.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
The StringReader type exposes the following members.
| Name | Description | |
|---|---|---|
![]() ![]() ![]() ![]() | StringReader | Initializes a new instance of the StringReader class that reads from the specified string. |
| Name | Description | |
|---|---|---|
![]() ![]() | Close | Closes the StringReader. (Overrides TextReader.Close().) |
![]() | CreateObjRef | Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.) |
![]() ![]() ![]() ![]() | Dispose() | Releases all resources used by the TextReader object. (Inherited from TextReader.) |
![]() ![]() ![]() ![]() | Dispose(Boolean) | Releases the unmanaged resources used by the StringReader and optionally releases the managed resources. (Overrides TextReader.Dispose(Boolean).) |
![]() ![]() ![]() ![]() | Equals(Object) | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
![]() ![]() ![]() ![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() ![]() ![]() ![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetLifetimeService | Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
![]() ![]() ![]() ![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | InitializeLifetimeService | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
![]() ![]() ![]() ![]() | MemberwiseClone() | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.) |
![]() ![]() ![]() ![]() | Peek | Returns the next available character but does not consume it. (Overrides TextReader.Peek().) |
![]() ![]() ![]() ![]() | Read() | Reads the next character from the input string and advances the character position by one character. (Overrides TextReader.Read().) |
![]() ![]() ![]() ![]() | Read(Char[], Int32, Int32) | Reads a block of characters from the input string and advances the character position by count. (Overrides TextReader.Read(Char[], Int32, Int32).) |
![]() ![]() | ReadAsync | Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index. (Overrides TextReader.ReadAsync(Char[], Int32, Int32).) |
![]() ![]() ![]() ![]() | ReadBlock | Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index. (Inherited from TextReader.) |
![]() ![]() | ReadBlockAsync | Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index. (Overrides TextReader.ReadBlockAsync(Char[], Int32, Int32).) |
![]() ![]() ![]() ![]() | ReadLine | Reads a line of characters from the current string and returns the data as a string. (Overrides TextReader.ReadLine().) |
![]() ![]() | ReadLineAsync | Reads a line of characters asynchronously from the current string and returns the data as a string. (Overrides TextReader.ReadLineAsync().) |
![]() ![]() ![]() ![]() | ReadToEnd | Reads all characters from the current position to the end of the string and returns them as a single string. (Overrides TextReader.ReadToEnd().) |
![]() ![]() | ReadToEndAsync | Reads all characters from the current position to the end of the string asynchronously and returns them as a single string. (Overrides TextReader.ReadToEndAsync().) |
![]() ![]() ![]() ![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
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. |
The following example shows how to read an entire string asynchronously.
using System; using System.IO; using System.Text; namespace ConsoleApplication { class Program { static void Main(string[] args) { ReadCharacters(); } static async void ReadCharacters() { StringBuilder stringToRead = new StringBuilder(); stringToRead.AppendLine("Characters in 1st line to read"); stringToRead.AppendLine("and 2nd line"); stringToRead.AppendLine("and the end"); using (StringReader reader = new StringReader(stringToRead.ToString())) { string readText = await reader.ReadToEndAsync(); Console.WriteLine(readText); } } } } // The example displays the following output: // // Characters in 1st line to read // and 2nd line // and the end //
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.




