IsolatedStorageSettings.Item Property

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

Gets or sets the value associated with the specified key.

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


Public Property Item ( _
    key As String _
) As Object
public Object this[
    string key
] { get; set; }


Property Value

Type: System.Object
The value associated with the specified key. If the specified key is not found, a get operation throws a KeyNotFoundException, and a set operation creates a new element that has the specified key.


IDictionary<TKey, TValue>.Item[TKey]


This property provides the ability to access a specific element in the collection by using the following syntax:

myCollection["key"] (C#)

myCollection("key") (Visual Basic)

You can also use the Item property to add new elements by setting the value of a key that does not exist in the Dictionary<TKey, TValue>. For example, use the following syntax to add a new element:

myCollection["myNonexistentKey"] = myValue (C#)

myCollection("myNonexistentKey") = myValue (Visual Basic)

However, if the specified key already exists in the Dictionary<TKey, TValue>, setting the Item property overwrites the old value. In contrast, the Add method does not modify existing elements.

A key cannot be nulla null reference (Nothing in Visual Basic), but a value can be if the value type TValue is a reference type.


The following example saves a string value from a TextBox named tbName to a user setting called name. It then accesses the saved name and uses it to display a personalized greeting in a TextBox named tbResults. If the name key does not exist, the "Hello, World" greeting is displayed instead. This example is part of a larger example for the IsolatedStorageSettings class.

userSettings("name") = tbName.Text
userSettings["name"] = tbName.Text;
' Retrieve and set user name.
    Dim name As String = CType(userSettings("name"), String)
    tbGreeting.Text = "Hello, " & name
Catch ex As System.Collections.Generic.KeyNotFoundException
    ' No preference is saved.
    tbGreeting.Text = "Hello, World"
End Try
// Retrieve and set user name.
    string name = (string)userSettings["name"];
    tbGreeting.Text = "Hello, " + name;
catch (System.Collections.Generic.KeyNotFoundException)
    // No preference is saved.
    tbGreeting.Text = "Hello, World";

Version Information


Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0


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