FileOpen Method (String, FileMode, FileAccess) |
Opens a
FileStream on the specified path, with the specified mode and access.
Namespace: System.IOAssembly: mscorlib (in mscorlib.dll) Version: 4.0.0.0
Syntax public static FileStream Open(
string path,
FileMode mode,
FileAccess access
)
Parameters
- path
- Type: SystemString
The file to open. - mode
- Type: System.IOFileMode
A 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. - access
- Type: System.IOFileAccess
A FileAccess value that specifies the operations that can be performed on the file.
Return Value
Type:
FileStreamAn unshared
FileStream that provides access to the specified file, with the specified mode and access.
Exceptions Exception | Condition |
---|
ArgumentException | path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.-or- access specified Read and mode specified Create, CreateNew, Truncate, or Append. |
ArgumentNullException | path is null. |
PathTooLongException | The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. |
DirectoryNotFoundException | The specified path is invalid, (for example, it is on an unmapped drive). |
IOException | An I/O error occurred while opening the file. |
UnauthorizedAccessException | path specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission. -or-mode is Create and the specified file is a hidden file. |
ArgumentOutOfRangeException | mode or access specified an invalid value. |
FileNotFoundException | The file specified in path was not found. |
NotSupportedException | path is in an invalid format. |
See Also