FileOpen Method (String, FileMode, FileAccess, FileShare) |
Opens a
FileStream on the specified path, having the specified mode with read, write, or read/write access and the specified sharing option.
Namespace: System.IOAssembly: mscorlib (in mscorlib.dll) Version: 4.0.0.0
Syntax public static FileStream Open(
string path,
FileMode mode,
FileAccess access,
FileShare share
)
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. - share
- Type: System.IOFileShare
A FileShare value specifying the type of access other threads have to the file.
Return Value
Type:
FileStreamA
FileStream on the specified path, having the specified mode with read, write, or read/write access and the specified sharing option.
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, access, or share specified an invalid value. |
FileNotFoundException | The file specified in path was not found. |
NotSupportedException | path is in an invalid format. |
See Also