Parameters

path

A string that specifies the complete file path to write to.

Permissions

Type	Reason
System.Security.Permissions.FileIOPermission	Requires permission for reading and writing files. See System.Security.Permissions.FileIOPermissionAccess.Read, System.Security.Permissions.FileIOPermissionAccess.Write

Exceptions

Type	Reason
System.IO.IOException	path is in an invalid format or contains invalid characters.
System.IO.DirectoryNotFoundException	The directory information specified in path was not found.
UnauthorizedAccessException	Access to path is denied.
ArgumentException	path is an empty string ("").
ArgumentNullException	path is null.
System.Security.SecurityException	The caller does not have the required permission.
System.IO.PathTooLongException	The length of path or the absolute path information for path exceeds the implementation-specific maximum length.

Remarks

This constructor initializes the StreamWriter.Encoding property to a System.Text.UTF8Encoding whose System.Text.Encoding.GetPreamble method returns an empty byte array. For additional information, see TextWriter.Encoding .

Note:

path is not required to be a file stored on disk; it can be any part of a system that supports access via streams. For example, depending on the system, this class might be able to access a physical device.

For information on the valid format and characters for path strings, see System.IO.Path .

The default buffer size can typically be around 4 KB.

Requirements

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0