StringWriter Constructor ()

 

Initializes a new instance of the StringWriter class.

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

public:
StringWriter()

A new StringBuilder object is automatically created and associated with the new instance of the StringWriter class. Since a format control is not specified for this constructor, the new instance will be initialized with CultureInfo::CurrentCulture.

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

File::AppendText

FileInfo::AppendText

Get the size of a file.

FileInfo::Length

Get the attributes of a file.

File::GetAttributes

Set the attributes of a file.

File::SetAttributes

Determine if a file exists.

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 how to construct a string using the StringWriter class.

using namespace System;
using namespace System::IO;
using namespace System::Text;
int main()
{
   StringWriter^ strWriter = gcnew StringWriter;

   // Use the three overloads of the Write method that are 
   // overridden by the StringWriter class.
   strWriter->Write( "file path characters are: " );
   strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
   strWriter->Write( Char::Parse( "." ) );

   // Use the underlying StringBuilder for more complex 
   // manipulations of the string.
   strWriter->GetStringBuilder()->Insert( 0, "Invalid " );

   Console::WriteLine( "The following string is {0} encoded.\n{1}", strWriter->Encoding->EncodingName, strWriter->ToString() );

}

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: