• Article

IsolatedStorageFile.OpenFile Method (String, FileMode, FileAccess)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Opens a file in the specified mode with the specified file access.

Namespace:  System.IO.IsolatedStorage
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Function OpenFile ( _
    path As String, _
    mode As FileMode, _
    access As FileAccess _
) As IsolatedStorageFileStream

public IsolatedStorageFileStream OpenFile(
    string path,
    FileMode mode,
    FileAccess access
)

Parameters

  • path
    Type: System.String
    The relative path of the file within the isolated store.

Return Value

Type: System.IO.IsolatedStorage.IsolatedStorageFileStream
A 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 nulla null reference (Nothing in Visual Basic).
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.

Examples

The following example opens a file for writing. This example is part of a larger example provided for IsolatedStorageFile class.

' 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

// 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, 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.