This documentation is archived and is not being maintained.

StringReader Class

Implements a TextReader that reads from a string.

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)

public ref class StringReader : public TextReader

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.

How to: Write Text to a File

Write to a text file.

How to: Write Text to a File

Read from a text file.

How to: Read Text from a File

Append text to a file.

How to: Open and Append to a Log 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.

How to: Read and Write to a Newly Created Data File

Write to a binary file.

How to: Read and Write to a Newly Created Data File

The following code example demonstrates the creation of a continuous paragraph from a group of double-spaced sentences, and then the conversion of the paragraph back to the original text.

using namespace System;
using namespace System::IO;
int main()
   String^ textReaderText = "TextReader is the abstract base " 
   "class of StreamReader and StringReader, which read " 
   "characters from streams and strings, respectively.\n\n" 
   "Create an instance of TextReader to open a text file " 
   "for reading a specified range of characters, or to " 
   "create a reader based on an existing stream.\n\n" 
   "You can also use an instance of TextReader to read " 
   "text from a custom backing store using the same " 
   "APIs you would use for a string or a stream.\n\n";
   Console::WriteLine(  "Original text:\n\n{0}", textReaderText );

   // From textReaderText, create a continuous paragraph  
   // with two spaces between each sentence.
      String^ aLine;
   String^ aParagraph;
   StringReader^ strReader = gcnew StringReader( textReaderText );
   while ( true )
      aLine = strReader->ReadLine();
      if ( aLine != nullptr )
         aParagraph = String::Concat( aParagraph, aLine,  " " );
         aParagraph = String::Concat( aParagraph,  "\n" );

   Console::WriteLine(  "Modified text:\n\n{0}", aParagraph );

   // Re-create textReaderText from aParagraph. 
   int intCharacter;
   Char convertedCharacter;
   StringWriter^ strWriter = gcnew StringWriter;
   strReader = gcnew StringReader( aParagraph );
   while ( true )
      intCharacter = strReader->Read();

      // Check for the end of the string  
      // before converting to a character. 
      if ( intCharacter == -1 )

      convertedCharacter = Convert::ToChar( intCharacter );
      if ( convertedCharacter == '.' )
         strWriter->Write(  ".\n\n" );

         // Bypass the spaces between sentences.
         strWriter->Write( convertedCharacter );

   Console::WriteLine(  "\nOriginal text:\n\n{0}", strWriter->ToString() );

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0