Mono Class Library: System.IO.File Overview | Members

System.IO.File.Open Method

Opens a System.IO.FileStream on the specified file. [Edit]

public static FileStream Open (string path, FileMode mode, FileAccess access)

Parameters

path
A string containing the name of the file to open. [Edit]
mode
A System.IO.FileMode value that specifies whether a file is created if one does not exist, and determines whether the contents of existing files are retained or overwritten. [Edit]
access
A System.IO.FileAccess value that specifies the operations that can be performed on the file. [Edit]
mode
Documentation for this section has not yet been entered. [Edit]
access
Documentation for this section has not yet been entered. [Edit]

Returns

A System.IO.FileStream that provides access to the specified file. [Edit]

Permissions

TypeReason
System.Security.Permissions.FileIOPermission [Edit] Requires permission to read and might also require permission to write to the file. See System.Security.Permissions.FileIOPermissionAccess.Read and System.Security.Permissions.FileIOPermissionAccess.Write.

Exceptions

TypeReason
System.Security.SecurityExceptionThe caller does not have the required permission. [Edit]
ArgumentException

path is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.

-or-

access specified Read and mode specified Create, CreateNew, Truncate or Append.

[Edit]
System.IO.FileNotFoundExceptionmode is FileMode.Truncate or FileMode.Open, but the specified file was not found. If a different mode is specified and the file was not found, a new one is created. [Edit]
ArgumentNullExceptionpath is null. [Edit]
ArgumentOutOfRangeExceptionmode or access specified an invalid value. [Edit]
System.IO.DirectoryNotFoundExceptionThe directory information specified in path was not found. [Edit]
System.IO.IOExceptionAn I/O error occurred, such as specifying FileMode.CreateNew when the file specified by path already exists. [Edit]
UnauthorizedAccessExceptionpath specified a read-only file and access is not Read, or path specified a directory. [Edit]
System.IO.PathTooLongExceptionThe length of path or the absolute path information for path exceeds the system-defined maximum length. [Edit]

Remarks

This method is equivalent to System.IO.FileStream (path, mode, access, FileShare.None ).

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.

[Edit]

Requirements

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