• Article

IsolatedStorageFile.CreateFile Method

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

Creates a file in the isolated store.

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

Syntax

'Declaration
Public Function CreateFile ( _
    path As String _
) As IsolatedStorageFileStream

public IsolatedStorageFileStream CreateFile(
    string path
)

Parameters

  • path
    Type: System.String
    The relative path of the file to be created in the isolated store.

Return Value

Type: System.IO.IsolatedStorage.IsolatedStorageFileStream
A new isolated storage file.

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

The isolated store has been disposed.

Examples

The following example creates files in the root of the store and in its subdirectories. This example is part of a larger example provided for IsolatedStorageFile class.

' Create a file in the root.
Dim rootFile As IsolatedStorageFileStream = _
    store.CreateFile("InTheRoot.txt")
rootFile.Close()


' Create a file in a subdirectory.
Dim subDirFile As IsolatedStorageFileStream = _
    store.CreateFile(Path.Combine(subdirectory1, "MyApp1A.txt"))
subDirFile.Close()

// Create a file in the root.
IsolatedStorageFileStream rootFile = store.CreateFile("InTheRoot.txt");
rootFile.Close();

// Create a file in a subdirectory.
IsolatedStorageFileStream subDirFile =
    store.CreateFile(Path.Combine(subdirectory1, "MyApp1A.txt"));
subDirFile.Close();

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.