Parameters

path

A string that specifies the complete file path to write to. [Edit]

Permissions

Type	Reason
System.Security.Permissions.FileIOPermission [Edit]	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. [Edit]
System.IO.DirectoryNotFoundException	The directory information specified in path was not found. [Edit]
UnauthorizedAccessException	Access to path is denied. [Edit]
ArgumentException	path is an empty string (""). [Edit]
ArgumentNullException	path is null. [Edit]
System.Security.SecurityException	The caller does not have the required permission. [Edit]
System.IO.PathTooLongException	The length of path or the absolute path information for path exceeds the implementation-specific maximum length. [Edit]

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.

[Edit]

Requirements

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