StringReader Class
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
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 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, 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.