IsolatedStorageFileStream Constructor (String^, FileMode, IsolatedStorageFile^)
Initializes a new instance of the IsolatedStorageFileStream class giving access to the file designated by path, in the specified mode, and in the context of the IsolatedStorageFile specified by isf.
Assembly: mscorlib (in mscorlib.dll)
public:
IsolatedStorageFileStream(
String^ path,
FileMode mode,
IsolatedStorageFile^ isf
)
Parameters
- path
-
Type:
System::String^
The relative path of the file within isolated storage.
- mode
-
Type:
System.IO::FileMode
One of the FileMode values.
- isf
-
Type:
System.IO.IsolatedStorage::IsolatedStorageFile^
The IsolatedStorageFile in which to open the IsolatedStorageFileStream.
| Exception | Condition |
|---|---|
| ArgumentException | The path is badly formed. |
| ArgumentNullException | The path is null. |
| FileNotFoundException | No file was found and the mode is set to Open. |
| IsolatedStorageException | isf does not have a quota. |
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. |
The following code example demonstrates the use of this constructor. For the complete context of this example, see the IsolatedStorageFileStream overview.
// This is the stream to which data will be written. IsolatedStorageFileStream^ source = gcnew IsolatedStorageFileStream( this->userName,FileMode::OpenOrCreate,isoFile ); // This is the stream from which data will be read. Console::WriteLine( "Is the source file readable? {0}", (source->CanRead ? (String^)"true" : "false") ); Console::WriteLine( "Creating new IsolatedStorageFileStream for Archive." ); // Open or create a writable file. IsolatedStorageFileStream^ target = gcnew IsolatedStorageFileStream( String::Concat("Archive\\",this->userName),FileMode::OpenOrCreate,FileAccess::Write,FileShare::Write,isoFile );
for isolated storage access
Available since 10
.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
