Item Property

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Gets or sets the element with the specified key.

Namespace:  System.Collections
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Property Item ( _
    key As Object _
) As Object

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

property Object^ Item[Object^ key] {
    Object^ get (Object^ key);
    void set (Object^ key, Object^ value);
}

abstract Item : 
        key:Object -> Object with get, set

JScript does not support indexed properties.

Parameters

• key
  Type: System. . :: . .Object
  The key of the element to get or set.

Property Value

Type: System. . :: . .Object
The element with the specified key, or nullNothingnullptrunita null reference (Nothing in Visual Basic) if the key does not exist.

Remarks

This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[key].

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 (for example, myCollection["myNonexistentKey"] = myValue). However, if the specified key already exists in the dictionary, setting the Item property overwrites the old value. In contrast, the Add method does not modify existing elements.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see dd66cd4c-b087-415f-9c3e-94e3a1835f74.

See Also

Reference

IDictionary Interface

System.Collections Namespace