IDictionary.Item[Object] Vlastnost

Definice

Získá nebo nastaví prvek se zadaným klíčem.Gets or sets the element with the specified key.

public:
 property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };
public object this[object key] { get; set; }
public object? this[object key] { get; set; }
member this.Item(obj) : obj with get, set
Default Public Property Item(key As Object) As Object

Parametry

key
Object

Klíč elementu, který se má načíst nebo nastavitThe key of the element to get or set.

Hodnota vlastnosti

Object

Prvek se zadaným klíčem, nebo null Pokud klíč neexistuje.The element with the specified key, or null if the key does not exist.

Výjimky

key je null.key is null.

Vlastnost je nastavena a IDictionary objekt je určen jen pro čtení.The property is set and the IDictionary object is read-only.

-nebo--or- Vlastnost je nastavena, key v kolekci neexistuje a IDictionary má pevnou velikost.The property is set, key does not exist in the collection, and the IDictionary has a fixed size.

Příklady

Následující příklad kódu ukazuje, jak implementovat Item[] vlastnost.The following code example demonstrates how to implement the Item[] property. Tento příklad kódu je součástí většího příkladu, který je k dispozici pro IDictionary třídu.This code example is part of a larger example provided for the IDictionary class.

public:
    virtual property Object^ default[Object^]
    {
        Object^ get(Object^ key)
        {
            // If this key is in the dictionary, return its value.
            int index;
            if (TryGetIndexOfKey(key, &index))
            {
                // The key was found; return its value.
                return items[index]->Value;
            }
            else
            {
                // The key was not found; return null.
                return nullptr;
            }
        }

        void set(Object^ key, Object^ value)
        {
            // If this key is in the dictionary, change its value.
            int index;
            if (TryGetIndexOfKey(key, &index))
            {
                // The key was found; change its value.
                items[index]->Value = value;
            }
            else
            {
                // This key is not in the dictionary; add this
                // key/value pair.
                Add(key, value);
            }
        }
    }
public object this[object key]
{
    get
    {
        // If this key is in the dictionary, return its value.
        Int32 index;
        if (TryGetIndexOfKey(key, out index))
        {
            // The key was found; return its value.
            return items[index].Value;
        }
        else
        {
            // The key was not found; return null.
            return null;
        }
    }

    set
    {
        // If this key is in the dictionary, change its value.
        Int32 index;
        if (TryGetIndexOfKey(key, out index))
        {
            // The key was found; change its value.
            items[index].Value = value;
        }
        else
        {
            // This key is not in the dictionary; add this key/value pair.
            Add(key, value);
        }
    }
}
Public Property Item(ByVal key As Object) As Object Implements IDictionary.Item
    Get

        ' If this key is in the dictionary, return its value.
        Dim index As Integer
        If TryGetIndexOfKey(key, index) Then

            ' The key was found return its value.
            Return items(index).Value
        Else

            ' The key was not found return null.
            Return Nothing
        End If
    End Get

    Set(ByVal value As Object)
        ' If this key is in the dictionary, change its value. 
        Dim index As Integer
        If TryGetIndexOfKey(key, index) Then

            ' The key was found change its value.
            items(index).Value = value
        Else

            ' This key is not in the dictionary add this key/value pair.
            Add(key, value)
        End If
    End Set
End Property

Poznámky

Tato vlastnost poskytuje možnost přístupu k určitému prvku v kolekci pomocí následující syntaxe: myCollection[key] .This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[key].

Vlastnost můžete použít také Item[] k přidání nových prvků nastavením hodnoty klíče, který ve slovníku neexistuje (například myCollection["myNonexistentKey"] = myValue ).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). Nicméně pokud zadaný klíč už ve slovníku existuje, nastavení Item[] vlastnosti přepíše starou hodnotu.However, if the specified key already exists in the dictionary, setting the Item[] property overwrites the old value. Naproti tomu Add metoda neupravuje existující prvky.In contrast, the Add method does not modify existing elements.

Implementace se mohou lišit v tom, zda umožňují klíč null .Implementations can vary in whether they allow the key to be null.

Jazyk C# používá this klíčové slovo This k definování indexerů namísto implementace Item[] Vlastnosti.The C# language uses the thisthis keyword to define the indexers instead of implementing the Item[] property. Visual Basic implementuje Item[] jako výchozí vlastnost, která poskytuje stejnou funkci indexování.Visual Basic implements Item[] as a default property, which provides the same indexing functionality.

Platí pro

Viz také