Parameters

path

A string containing relative or absolute path for the file that the current System.IO.FileStream object will encapsulate.

mode

A System.IO.FileMode value that determines how to open or create the file.

access

A System.IO.FileAccess value that determines how the file can be accessed by the System.IO.FileStream object. This parameter is used to specify the initial values of the FileStream.CanRead and FileStream.CanWrite properties. For additional information, see Stream.CanRead and Stream.CanWrite.

share

A System.IO.FileShare value that determines how the file will be shared by processes.

Permissions

Type	Reason
System.Security.Permissions.FileIOPermission	Requires permission to read, write, and append to files. See System.Security.Permissions.FileIOPermissionAccess.Read, System.Security.Permissions.FileIOPermissionAccess.Write, and System.Security.Permissions.FileIOPermissionAccess.Append.

Exceptions

Type	Reason
ArgumentNullException	path is null.
ArgumentException	path is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.
System.IO.FileNotFoundException	mode is FileMode.Truncate or FileMode.Open , but the specified file cannot be found. If a different mode is specified and the file cannot be found, a new one is created.
System.IO.IOException	An I/O error occurred, such as specifying FileMode.CreateNew and the file specified by path already exists.
System.Security.SecurityException	The caller does not have the required permission.
System.IO.DirectoryNotFoundException	The directory information specified by path does not exist.
UnauthorizedAccessException	The access requested is not permitted by the operating system for the specified path.
System.IO.PathTooLongException	The length of path or the absolute path information for path exceeds the system-defined maximum length.
ArgumentOutOfRangeException	mode, access, or share contains an invalid value.

Remarks

This constructor sets read/write access to the file.

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.

Stream.CanSeek is true for all System.IO.FileStream objects that encapsulate files. If path indicates a device that does not support seeking, the FileStream.CanSeek property on the resulting System.IO.FileStream is required to be false. For additional information, see Stream.CanSeek .

Requirements

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