Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IsolatedStorageSettings.Item Property

July 28, 2014

Gets or sets the value associated with the specified key.

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

public Object this[
	string key
] { get; set; }

Parameters

key
Type: System.String
The key of the item to get or 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.

Implements

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 null, 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;



// Retrieve and set user name.
try
{
    string name = (string)userSettings["name"];
    tbGreeting.Text = "Hello, " + name;
}
catch (System.Collections.Generic.KeyNotFoundException)
{
    // No preference is saved.
    tbGreeting.Text = "Hello, World";
}


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2014 Microsoft