IsolatedStorageFile::GetUserStoreForDomain Method ()

.NET Framework (current version)

Obtains user-scoped isolated storage corresponding to the application domain identity and assembly identity.

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

Syntax

public:
static IsolatedStorageFile^ GetUserStoreForDomain()

Return Value

Type: System.IO.IsolatedStorage::IsolatedStorageFile^

An object corresponding to the IsolatedStorageScope, based on a combination of the application domain identity and the assembly identity.

Exceptions

Exception	Condition
SecurityException	Sufficient isolated storage permissions have not been granted.
IsolatedStorageException	The store failed to open. -or- The assembly specified has insufficient permissions to create isolated stores. -or- An isolated storage location cannot be initialized. -or- The permissions for the application domain cannot be determined.

Remarks

The same assembly code will use different isolated stores when used in the context of different applications.

GetUserStoreForDomain is functionally equivalent to the following code:

C++

isoFile = IsolatedStorageFile::GetStore(IsolatedStorageScope::Assembly |
    IsolatedStorageScope::Domain | IsolatedStorageScope::User,
    (Type^)nullptr, (Type^)nullptr);

Different assemblies running within the same application domain always have distinct isolated stores.

Note
GetUserStoreForDomain will return an IsolatedStorageFile object without a quota if the application domain in which the assembly is installed does not have IsolatedStorageFilePermission. Later attempts to create an IsolatedStorageFile object using the IsolatedStorageFile object that does not have a quota will fail with an IsolatedStorageException.

Examples

The following code example demonstrates the GetUserStoreForDomain method. For the complete context of this example, see the IsolatedStorageFile overview.

C++

IsolatedStorageFile^ isoFile;
isoFile = IsolatedStorageFile::GetUserStoreForDomain();

// Open or create a writable file.
IsolatedStorageFileStream^ isoStream = gcnew IsolatedStorageFileStream( this->userName,FileMode::OpenOrCreate,FileAccess::Write,isoFile );
StreamWriter^ writer = gcnew StreamWriter( isoStream );
writer->WriteLine( this->NewsUrl );
writer->WriteLine( this->SportsUrl );

// Calculate the amount of space used to record the user's preferences.
double d = isoFile->CurrentSize / isoFile->MaximumSize;
Console::WriteLine( "CurrentSize = {0}", isoFile->CurrentSize.ToString() );
Console::WriteLine( "MaximumSize = {0}", isoFile->MaximumSize.ToString() );
writer->Close();
isoFile->Close();
isoStream->Close();
return d;