File.Open Method (String, FileMode)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
When it is called by trusted applications, opens a FileStream on the specified path with read/write access.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Shared Function Open ( _
path As String, _
mode As FileMode _
) As FileStream
public static FileStream Open(
string path,
FileMode mode
)
Parameters
- path
Type: System.String
The file to open.
- mode
Type: System.IO.FileMode
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.
Return Value
Type: System.IO.FileStream
A FileStream opened in the specified mode and path, with read/write access and not shared.
Exceptions
Exception | Condition |
---|---|
ArgumentException | path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by GetInvalidPathChars. |
ArgumentNullException | path is nulla null reference (Nothing in Visual Basic). |
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. -or- This operation is not supported on the current platform. -or- path specified a directory. -or- The caller does not have the required permission. |
ArgumentOutOfRangeException | mode specified an invalid value. |
FileNotFoundException | The file specified in path was not found. |
NotSupportedException | path is in an invalid format. |
Remarks
Platform Notes
Silverlight for Windows Phone
This member has a SecurityCriticalAttribute attribute on Silverlight for Windows Phone, because the attribute was present in Silverlight 3. This attribute restricts this member to internal use. Application code that uses this member throws a MethodAccessException.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.