IsolatedStorageSettings.SiteSettings Property

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

Gets an instance of IsolatedStorageSettings that contains the contents of the application's IsolatedStorageFile, scoped at the ___domain level, or creates a new instance of IsolatedStorageSettings if one does not exist.

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

Syntax

'Declaration
Public Shared ReadOnly Property SiteSettings As IsolatedStorageSettings
public static IsolatedStorageSettings SiteSettings { get; }

Property Value

Type: System.IO.IsolatedStorage.IsolatedStorageSettings
An IsolatedStorageSettings object that contains the contents of the application's IsolatedStorageFile, scoped at the ___domain level. If an instance does not already exist, a new instance is created.

Remarks

Use the SiteSettings property to create a new instance of the dictionary used to store key-value pairs in isolated storage.

SiteSettings are specific to a user, but are shared across applications in the same sub-___domain. For example, an application at https://www.contoso.com/site1/application.xap will share SiteSettings with an application at https://www.contoso.com/site2/application.xap. However, SiteSettings for applications at https://www.contoso.com/ will be isolated from applications at http://dev.contoso.com/ because they are hosted on different sub-domains.

Examples

The following example initializes a SiteSettings dictionary.

[Visual Basic]

Private userSettings As IsolatedStorageSettings = _
    IsolatedStorageSettings.SiteSettings

[C#]

private IsolatedStorageSettings userSettings =
    IsolatedStorageSettings.SiteSettings;

Version Information

Silverlight

Supported in: 5, 4, 3

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.