Parameters

path

A string containing the name of the file.

bufferSize

A int containing the number of bytes buffered for reads and writes to the file.

Returns

A System.IO.FileStream that provides read/write access to the specified file.

Permissions

Type	Reason
System.Security.Permissions.FileIOPermission	Requires permission to write the specified file. See System.Security.Permissions.FileIOPermissionAccess.Write.

Exceptions

Type	Reason
System.Security.SecurityException	The caller does not have the required permission.
ArgumentException	path is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.
ArgumentNullException	path is null.
System.IO.DirectoryNotFoundException	The directory information specified in path was not found.
System.IO.IOException	An I/O error occurred while creating the file.
UnauthorizedAccessException	The caller does not have the required permission.
System.IO.PathTooLongException	The length of path or the absolute path information for path exceeds the system-defined maximum length.

Remarks

This method is equivalent to System.IO.FileStream (path, FileMode.Create, FileAccess.ReadWrite, FileShare.None , bufferSize).

If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

The path argument is permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory.

Note: To obtain the current working directory, see Directory.GetCurrentDirectory.

Requirements

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