PropertyCollection.IDictionary.Item[Object] Właściwość

Definicja

Pobiera lub ustawia element przy użyciu określonego klucza.

C#
object System.Collections.IDictionary.Item[object key] { get; set; }
C#
object? System.Collections.IDictionary.Item[object key] { get; set; }

Parametry

key
Object

Klucz elementu do pobrania lub ustawienia.

Wartość właściwości

Element z określonym kluczem.

Implementuje

Wyjątki

key to null.

Właściwość jest ustawiona, a IDictionary obiekt jest tylko do odczytu.

-lub-

Właściwość jest ustawiona, key nie istnieje w kolekcji i IDictionary ma stały rozmiar.

Przykłady

W poniższym przykładzie pokazano, jak zaimplementować Item[] właściwość . Ten przykład kodu jest częścią większego przykładu udostępnionego IDictionary dla klasy .

C#
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);
        }
    }
}

Uwagi

Ta właściwość umożliwia dostęp do określonego elementu w kolekcji przy użyciu następującej składni: myCollection[key].

Możesz również użyć Item[] właściwości , aby dodać nowe elementy, ustawiając wartość klucza, który nie istnieje w słowniku (na przykład myCollection["myNonexistentKey"] = myValue). Jeśli jednak określony klucz już istnieje w słowniku, ustawienie Item[] właściwości zastępuje starą wartość. Z kolei Add metoda nie modyfikuje istniejących elementów.

Dotyczy

Produkt Wersje
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Zobacz też