IsolatedStorageFileStream Constructor (String^, FileMode)

.NET Framework (current version)

Initializes a new instance of an IsolatedStorageFileStream object giving access to the file designated by path in the specified mode.

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

Syntax

C++

public:
IsolatedStorageFileStream(
	String^ path,
	FileMode mode
)

Parameters

path: Type: System::String^
The relative path of the file within isolated storage.

mode: Type: System.IO::FileMode
One of the FileMode values.

Exceptions

Exception	Condition
ArgumentException	The path is badly formed.
ArgumentNullException	The path is null.
DirectoryNotFoundException	The directory in path does not exist.
FileNotFoundException	No file was found and the mode is set to Open

The isolated store that is used is scoped by the current executing assembly's identity and that of the application domain in which it is running. This store will remain open only for the lifetime of the IsolatedStorageFileStream object. To specify a different isolated storage scope, or to allow the store to remain open (so multiple IsolatedStorageFileStream objects can be opened from it), use the form of the constructor that accepts an IsolatedStorageFile object.

The mode parameter indicates whether a new file should be created, an existing one used, and so on.

Caution
When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable and can cause an exception to be thrown.

Security

IsolatedStorageFilePermission

for isolated storage access

Version Information

.NET Framework
Available since 1.1