StreamWriter Constructor (Stream)

July 28, 2014

Initializes a new instance of the StreamWriter class for the specified stream, using UTF-8 encoding and the default buffer size.

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

'Declaration
Public Sub New ( _
	stream As Stream _
)

Parameters

stream
Type: System.IO.Stream
The stream to write to.

ExceptionCondition
ArgumentException

stream is not writable.

ArgumentNullException

stream is Nothing.

This constructor creates a StreamWriter with UTF-8 encoding without a byte order mark (BOM), so its GetPreamble method returns an empty byte array. The BaseStream property is initialized using the stream parameter.

The StreamWriter object calls Dispose on the provided Stream object when StreamWriter.Dispose is called.

Caution noteCaution:

When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable and could cause an exception to be thrown.

Version Notes

Windows Phone

 If you pass an invalid input path to a StreamWriter constructor, the constructor throws InvalidArgumentException instead of DirectoryNotFoundException.

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft