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.