Makale
11/17/2011

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.

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

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.

' 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.

Aracılığıyla paylaş