IsolatedStorageFile.GetUserStoreForApplication Method

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

Obtains user-scoped isolated storage for use by an application that calls from the virtual host domain.

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

Syntax

'Declaration
<SecuritySafeCriticalAttribute> _
Public Shared Function GetUserStoreForApplication As IsolatedStorageFile
[SecuritySafeCriticalAttribute]
public static IsolatedStorageFile GetUserStoreForApplication()

Return Value

Type: System.IO.IsolatedStorage.IsolatedStorageFile
The isolated storage file that corresponds to the isolated storage scope based on the identity of an application in a virtual host domain.

Exceptions

Exception Condition
IsolatedStorageException

The group quota for the store is set to zero.

-or-

The store has been removed but cannot be recreated because a directory or file is being used by another process.

-or-

Isolated storage is disabled.

Remarks

An application on a domain (Web site) shares a group quota with all the other applications in that domain. This enables multiple applications in the same domain to share a single quota. Note that domain in this context refers to a virtual host domain, such as Microsoft.com, not to an application domain.

The default isolated storage size for a group quota is 1 megabyte. To increase the quota, use the IncreaseQuotaTo method.

To obtain the isolated storage for a user by all the applications in the domain, use the GetUserStoreForSite method.

If an earlier call to the Remove method failed, the GetUserStoreForApplication method does not clean up the directories or files in the store. Any subsequent attempts to modify the store throw an IsolatedStorageException exception. In this case, you must ensure that the files or directories are explicitly deleted.

Examples

The following example obtains a store. This example is part of a larger example provided for IsolatedStorageFile class.

Using store As IsolatedStorageFile = _
    IsolatedStorageFile.GetUserStoreForApplication()


...


End Using
using (var store = IsolatedStorageFile.GetUserStoreForApplication())
{


...


}

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.