.NET Framework Class Library for Silverlight
IsolatedStorageFile.OpenFile Method (String, FileMode, FileAccess)
Opens a file in the specified mode with the specified file access.
Namespace: System.IO.IsolatedStorage
Assembly: mscorlib (in mscorlib.dll)
Syntax
Visual Basic (Declaration)
Public Function OpenFile ( _ path As String, _ mode As FileMode, _ access As FileAccess _ ) As IsolatedStorageFileStream
C#
public IsolatedStorageFileStream OpenFile( string path, FileMode mode, FileAccess access )
Parameters
- path
- Type: System.String
The relative path of the file within the isolated store.
- mode
- Type: System.IO.FileMode
The mode in which to open the file.
- access
- Type: System.IO.FileAccess
The type of access to open the file with.
Return Value
Type: System.IO.IsolatedStorage.IsolatedStorageFileStreamA file that is opened in the specified mode and access, and is unshared.
Exceptions
| Exception | Condition |
|---|---|
| IsolatedStorageException |
The isolated store has been removed. -or- Isolated storage is disabled. |
| ArgumentException |
path is malformed. |
| ArgumentNullException |
path is null. |
| DirectoryNotFoundException |
The directory in path does not exist. |
| FileNotFoundException |
No file was found and the mode is set to Open . |
| ObjectDisposedException |
The isolated store has been disposed. |
Remarks
This method is equivalent to using the IsolatedStorageFileStream.IsolatedStorageFileStream(String, FileMode, FileAccess, IsolatedStorageFile) constructor.
Examples
The following example opens a file for writing. This example is part of a larger example provided for IsolatedStorageFile class.
Visual Basic
' Write to an existing file: MyApp1\SubDir1\MyApp1A.txt ' Determine if the file exists before writing to it. Dim filePath As String = Path.Combine(subdirectory1, "MyApp1A.txt") If store.FileExists(filePath) Then Try Using sw As StreamWriter = _ New StreamWriter(store.OpenFile(filePath, FileMode.Open, FileAccess.Write)) sw.WriteLine("To do list:") sw.WriteLine("1. Buy supplies.") End Using Catch ex As IsolatedStorageException sb.AppendLine(ex.Message) End Try Else sb.AppendLine((filePath + "does not exist")) End If
C#
// Write to an existing file: MyApp1\SubDir1\MyApp1A.txt // Determine if the file exists before writing to it. string filePath = Path.Combine(subdirectory1, "MyApp1A.txt"); if (store.FileExists(filePath)) { try { using (StreamWriter sw = new StreamWriter(store.OpenFile(filePath, FileMode.Open, FileAccess.Write))) { sw.WriteLine("To do list:"); sw.WriteLine("1. Buy supplies."); } } catch (IsolatedStorageException ex) { sb.AppendLine(ex.Message); } }
Version Information
Silverlight
Supported in: 5, 4, 3Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
See Also