IsolatedStorageFile.GetStore Method (IsolatedStorageScope, Object, Object)

 

Obtains the isolated storage corresponding to the given application domain and assembly evidence objects.

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

public static IsolatedStorageFile GetStore(
	IsolatedStorageScope scope,
	object domainIdentity,
	object assemblyIdentity
)

Parameters

scope
Type: System.IO.IsolatedStorage.IsolatedStorageScope

A bitwise combination of the enumeration values.

domainIdentity
Type: System.Object

An object that contains evidence for the application domain identity.

assemblyIdentity
Type: System.Object

An object that contains evidence for the code assembly identity.

Return Value

Type: System.IO.IsolatedStorage.IsolatedStorageFile

An object that represents the parameters.

Exception Condition
SecurityException

Sufficient isolated storage permissions have not been granted.

ArgumentNullException

Neither domainIdentity nor assemblyIdentity has been passed in. This verifies that the correct constructor is being used.

-or-

Either domainIdentity or assemblyIdentity is null.

ArgumentException

The scope is invalid.

IsolatedStorageException

An isolated storage location cannot be initialized.

-or-

scope contains the enumeration value Application, but the application identity of the caller cannot be determined, because the ActivationContext for the current application domain returned null.

-or-

scope contains the value Domain, but the permissions for the application domain cannot be determined.

-or-

scope contains the value Assembly, but the permissions for the calling assembly cannot be determined.

This form of GetStore is most useful for administrative code that needs to open a store as if it were another assembly. The store is opened for the evidence provided and not for the currently executing assembly.

System_CAPS_noteNote

If the scope parameter is Domain and the application domain in which the assembly is installed does not have IsolatedStorageFilePermission, the GetStore method will return an IsolatedStorageFile object without a quota. Later attempts to create an IsolatedStorageFile object using the IsolatedStorageFile object that does not have a quota will fail with an IsolatedStorageException.

IsolatedStorageFilePermission

for using isolated storage. Associated enumeration: AdministerIsolatedStorageByUser

ReflectionPermission

when invoked late-bound through mechanisms such as Type.InvokeMember. Associated enumeration: ReflectionPermissionFlag.MemberAccess

.NET Framework
Available since 1.1
Return to top
Show: